Auseklis Astrology MCP server
✓ VerifiedEnables AI agents to compute accurate natal charts, transits, synastry, and astronomical events using a real ephemeris.
Also known as igmizo/auseklis, auseklis
- Stars
- 1
- Tools
- 12
- Downloads, 30 days
- —
- Latest version
- 0.4.0
- Last commit
- Jul 10, 2026
- License
- MIT
What is Auseklis Astrology MCP?
Auseklis Astrology enables AI agents to compute accurate natal charts, transits, synastry, and astronomical events using a real ephemeris. It exposes 12 tools, such as get_planet_position, compute_natal_chart, compute_transits.
Summary generated from the project's README
About Auseklis Astrology MCP server
Auseklis Astrology provides AI agents with a precise astronomical engine to calculate astrological data without the risk of hallucinating planetary positions. It allows developers to integrate natal charts, transits, synastry, and various astronomical events into their AI workflows. The server supports multiple house systems like Placidus and Porphyry, as well as both tropical and sidereal zodiacs including Lahiri and Fagan/Bradley ayanamsas.
Users can run this server locally via stdio using npx or deploy it as a remote service on Cloudflare Workers using Streamable HTTP. It requires no API keys or external configuration because the ephemeris is computed locally. The system handles complex time conversions using the IANA timezone database to ensure accurate UTC calculations from local birth times.
Specific tools include get_planet_position for individual body data, compute_natal_chart for full birth profiles, and find_eclipses for lunar and solar event visibility. It also offers specialized functions like compute_progressions, find_retrograde_periods, and find_sign_ingresses to track celestial movements over time.
Written from the project's README. Every use case is checked against a quote from it.
How to install Auseklis Astrology MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Auseklis Astrology MCP in Claude Code
$ claude mcp add auseklis -- npx -y auseklisInstall Auseklis Astrology MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"auseklis": {
"command": "npx",
"args": [
"-y",
"auseklis"
]
}
}
}Install Auseklis Astrology MCP in VS Code
.vscode/mcp.json
{
"servers": {
"auseklis": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"auseklis"
]
}
}
}Install Auseklis Astrology MCP in VS Code CLI
$ code --add-mcp '{"name":"auseklis","type":"stdio","command":"npx","args":["-y","auseklis"]}'Install Auseklis Astrology MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"auseklis": {
"command": "npx",
"args": [
"-y",
"auseklis"
]
}
}
}Install Auseklis Astrology MCP in Codex
$ codex mcp add auseklis -- npx -y auseklisInstall Auseklis Astrology MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.auseklis] command = "npx" args = ["-y", "auseklis"]
Install Auseklis Astrology MCP in Gemini CLI
$ gemini mcp add -s user auseklis npx -- -y auseklisInstall Auseklis Astrology MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"auseklis": {
"command": "npx",
"args": [
"-y",
"auseklis"
]
}
}
}Auseklis Astrology MCP tools 12
Detected from the READMEget_planet_positioncompute_natal_chartcompute_transitscompute_progressionscompute_synastrycompute_composite_chartfind_returnsget_moon_phasefind_eclipsesfind_retrograde_periodsfind_sign_ingressesfind_aspect_times
| get_planet_position | — | |
| compute_natal_chart | — | |
| compute_transits | — | |
| compute_progressions | — | |
| compute_synastry | — | |
| compute_composite_chart | — | |
| find_returns | — | |
| get_moon_phase | — | |
| find_eclipses | — | |
| find_retrograde_periods | — | |
| find_sign_ingresses | — | |
| find_aspect_times | — |
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableigmizo/auseklis is public and reachablegithub.com/igmizo/auseklis ↗Pass
- Package names this repository as its sourceauseklis names igmizo/auseklis as sourcenpmjs.com/package/auseklis ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for auseklisnpmjs.com/package/auseklis/v/0.4.0#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-07-10github.com/igmizo/auseklis ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from auseklisPass
- No critical advisory in the package or its dependencies101 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubauseklis
Astrology MCP server — natal charts, transits, synastry, progressions, returns, eclipses, retrogrades, moon phases. Computed from a real ephemeris, so AI agents stop hallucinating planet positions.
Named after the Latvian morning star. MIT-licensed with no AGPL ephemeris data — see Licensing.
Tools
| Tool | What it does |
|---|---|
get_planet_position |
Position of one body/point at a moment (sign, degree, speed, retrograde) |
compute_natal_chart |
Full birth chart: 13 points, houses, angles, Part of Fortune, aspects |
compute_transits |
Aspects from the current (or any) sky to a natal chart |
compute_progressions |
Secondary progressions (day-for-a-year) |
compute_synastry |
Cross-chart aspects between two people |
compute_composite_chart |
Midpoint composite chart of a relationship |
find_returns |
Solar/lunar/planetary returns (exact moments) |
get_moon_phase |
Phase, illumination, Moon sign, next four quarters |
find_eclipses |
Lunar/solar eclipses with signs, incl. local visibility |
find_retrograde_periods |
Station retrograde/direct moments for any planet |
find_sign_ingresses |
When a body changes signs (equinoxes, Saturn ingresses, …) |
find_aspect_times |
Exact moment a transit perfects ("when does Saturn square my Sun?") |
Plus two prompts (natal_chart_reading, current_sky_report) and a glossary resource (auseklis://glossary).
Features: local birth times with IANA timezones (full historical DST handling) · tropical and sidereal (Lahiri, Fagan/Bradley) zodiacs · whole-sign, equal, Porphyry, and Placidus houses · mean lunar nodes and Black Moon Lilith · Part of Fortune (classical day/night formula).
Installation
Claude Code
claude mcp add auseklis -- npx -y auseklis
Claude Desktop / any MCP client (stdio)
{
"mcpServers": {
"auseklis": {
"command": "npx",
"args": ["-y", "auseklis"]
}
}
}
No API keys, no configuration — the ephemeris is computed locally.
Desktop Extension
Download auseklis.mcpb from the releases page and double-click to install in Claude Desktop. Or build it yourself: npm run bundle.
Remote (self-hosted)
The same server runs as a Cloudflare Worker speaking Streamable HTTP. Deploy it to your own account:
npm run deploy # wrangler deploy
claude mcp add --transport http auseklis https://auseklis.<your-subdomain>.workers.dev/mcp
Set the MCP_SHARED_SECRET secret to require a bearer token.
Library usage
The ephemeris core (everything under src/ephemeris/) is importable directly — no MCP client or subprocess needed. This is the right shape for serverless runtimes (Vercel, Workers), where spawning npx auseklis per request is not an option:
import { computeNatalChart } from "auseklis/ephemeris";
import { findRetrogradePeriods } from "auseklis/ephemeris/events";
import { findEclipses } from "auseklis/ephemeris/eclipses";
const chart = computeNatalChart({
utc: "1990-03-15T13:45:00Z",
location: { latitude: 56.95, longitude: 24.11 }, // Riga
houseSystem: "placidus",
});
auseklis/ephemeris carries the chart math (natal, transits, synastry, composite, progressions, single positions, angles) plus resolveInstant for local-time → UTC conversion; …/events and …/eclipses carry the time-domain searches. Fully typed, ESM only, no data files.
Example questions to ask
- "Compute my natal chart — born 15 March 1990, 15:45 in Riga."
- "What's transiting my Sun this month?"
- "When exactly is my Saturn return?"
- "Synastry between me and my partner?" (two birth date/times)
- "When is Mercury retrograde in 2027, and in which signs?"
- "Is tonight's full moon visible as an eclipse from here?"
The model handles place-name → coordinates; the server handles local-time → UTC via the IANA timezone database.
Accuracy
Positions come from astronomy-engine (VSOP87 + NOVAS C 3.1): ±1 arcminute for 1700–2200, far below the 1° resolution astrological interpretation uses. Event searches (stations, ingresses, returns, quarters) are refined to ~1 second of time. Verified in CI against published eclipse dates, the 2026 equinox, NOVAS Sun positions, and an independent Placidus implementation.
Architecture
src/
├── ephemeris/ Astrology core — backend-agnostic
│ ├── engine.ts EphemerisBackend interface + astronomy-engine adapter (the swap seam)
│ ├── index.ts Charts, aspects, synastry, composite, progressions
│ ├── events.ts Time searches: returns, stations, ingresses, aspect times, moon phases
│ ├── eclipses.ts Eclipse searches with astrological context
│ ├── houses.ts Whole-sign, equal, Porphyry, Placidus (semi-arc solver)
│ ├── points.ts Mean lunar nodes, Black Moon Lilith
│ ├── sidereal.ts Ayanamsa (Lahiri, Fagan/Bradley)
│ └── time.ts IANA timezone → UTC conversion (no dependencies, uses Intl)
├── mcp/ Tool/prompt/resource definitions on @modelcontextprotocol/sdk
├── stdio.ts Local entry — `npx auseklis`
└── index.ts Remote entry — Cloudflare Worker, Streamable HTTP via @hono/mcp
The EphemerisBackend interface in engine.ts is the deliberate swap seam: a future Rust/WASM clean-room ephemeris only needs to reimplement that one interface.
Development
npm install
npm run typecheck # strict TS
npm test # 23-check smoke suite (ephemeris references + MCP end-to-end)
npm run build # emit dist/
npm run dev # local Cloudflare Worker on :8787
npx @modelcontextprotocol/inspector node dist/stdio.js # poke tools interactively
See docs/tools.md for the full tool reference and docs/architecture.md for design notes.
Licensing
MIT. This project deliberately avoids the Swiss Ephemeris (.se1/.se2 data files and the sweph bindings): those are AGPL-licensed, which would impose AGPL obligations on any network service built on them. Everything here is computed from MIT-licensed code with no external data files — safe to embed, fork, and deploy commercially. Details in NOTICE.
The trade-off: no Chiron or asteroids (they need ephemeris data files). They are on the roadmap via public-domain JPL-derived data.
Roadmap
- v1: Rust/WASM clean-room ephemeris backend behind the same
EphemerisBackendseam - Chiron + major asteroids from public-domain JPL data
- Koch houses, declination/parallel aspects
Auseklis Astrology MCP questions
How do I add Auseklis Astrology MCP to Claude Code?
Run claude mcp add auseklis -- npx -y auseklis in your terminal. Add --scope user to make it available in every project.
How do I add Auseklis Astrology MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Auseklis Astrology MCP provide?
It exposes 12 tools, including get_planet_position, compute_natal_chart, compute_transits, compute_progressions, compute_synastry.
Does this server require an API key?
No, the ephemeris is computed locally and requires no API keys or configuration.
What house systems and zodiacs are supported?
It supports tropical and sidereal (Lahiri, Fagan/Bradley) zodiacs, as well as whole-sign, equal, Porphyry, and Placidus house systems.