Log inSubmit server
Auseklis Astrology logo

Auseklis Astrology

Computes natal charts, transits, relationship charts, and timed astrology events locally without API keys.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Auseklis Astrology

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "auseklis-astrology": {
      "command": "npx",
      "args": [
        "-y",
        "auseklis"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y auseklis

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 6d ago.

Overview

Auseklis Astrology MCP server computes natal charts, transits, progressions, synastry, returns, eclipses, and other astrology events from a local astronomy-based ephemeris. It exposes these calculations through MCP tools, with support for local birth times, IANA time zones, multiple zodiac systems, and several house systems. Use it when an AI agent needs precise planetary positions or date-and-time searches without an external astrology API. It runs locally over stdio or can be deployed as a self-hosted Cloudflare Worker over Streamable HTTP.

Use cases

  • Generate a natal chart from a birth time and location
  • Track transits and exact aspect times
  • Compare two birth charts with synastry
  • Find eclipses, returns, retrogrades, and sign ingresses
  • Calculate progressions or a relationship composite chart

Key features

  • Local ephemeris calculations without API keys
  • Natal, transit, progression, synastry, and composite charts
  • Returns, eclipses, retrogrades, ingresses, and aspect-time searches
  • Tropical and Lahiri or Fagan/Bradley sidereal zodiacs
  • Whole-sign, equal, Porphyry, and Placidus houses
  • IANA timezone handling with historical daylight-saving rules

Tools12

What Auseklis Astrology lets your agent do. Expand a tool for its parameters.

Self-reported~212 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

5/5 checks healthy over the last 35d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · auseklis (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads264Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed12Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Auseklis Astrology works

What Auseklis Astrology does

The Auseklis Astrology MCP server provides astrology calculations for AI agents through the Model Context Protocol. It covers individual planetary positions, complete natal charts, transits, secondary progressions, synastry, midpoint composite charts, returns, lunar phases, eclipses, retrograde periods, sign ingresses, and exact aspect times.

Auseklis Astrology also includes two prompts, natal_chart_reading and current_sky_report, plus a glossary resource at auseklis://glossary. These additions give MCP clients structured ways to request readings or consult terminology alongside the calculation tools.

How it works

Calculations use astronomy-engine, based on VSOP87 and NOVAS C 3.1, rather than external ephemeris data files. The project reports planetary position accuracy of about one arcminute for dates from 1700 through 2200, while event searches such as stations, ingresses, returns, and lunar quarters are refined to roughly one second.

The server accepts local birth times with IANA time zones and resolves them to UTC, including historical daylight-saving rules. It supports tropical zodiac calculations, plus Lahiri and Fagan/Bradley sidereal options. Available house systems are whole-sign, equal, Porphyry, and Placidus. Mean lunar nodes, Black Moon Lilith, and the classical day/night Part of Fortune formula are included in relevant chart calculations.

Setup and configuration

For local use, install the package through npx and register it with an MCP client. Claude Code can use claude mcp add auseklis -- npx -y auseklis; Claude Desktop and other stdio clients can configure npx as the command with -y and auseklis as its arguments. No API key or application configuration is required for local operation.

A desktop extension is available as an .mcpb release asset for Claude Desktop. The same project can also run as a Cloudflare Worker using Streamable HTTP. A self-hosted remote deployment may set MCP_SHARED_SECRET to require a bearer token.

The calculation library is separately importable from auseklis/ephemeris, with event and eclipse functionality available from its related modules. This option is intended for applications such as serverless runtimes that cannot spawn the MCP process per request.

Tools and capabilities

The exposed tools support the following workflows:

  • Inspect a body or point at a specific moment, including sign, degree, speed, and retrograde status.
  • Generate natal charts with points, houses, angles, aspects, and Part of Fortune.
  • Compare a natal chart with current or selected sky positions.
  • Calculate progressions, synastry, and relationship composite charts.
  • Find solar, lunar, and planetary returns with their exact moments.
  • Check Moon phase details, upcoming quarter times, and lunar or solar eclipses, including local visibility.
  • Search for retrograde stations, direct stations, sign ingresses, and exact transit aspect times.

Limitations and notes

Auseklis Astrology deliberately does not use Swiss Ephemeris data files or sweph bindings. As a result, Chiron and asteroids are not currently available because they require separate ephemeris data files. The project identifies public-domain JPL-derived data as a future route for adding them.

The server has no client-specific API-key requirement, but a remote deployment is self-hosted and may use a shared secret for bearer-token authentication. Its supported remote entry point is a Cloudflare Worker using Streamable HTTP; local execution uses stdio. The library is ESM-only and fully typed according to the project description.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Auseklis Astrology

Auseklis Astrology is an MCP server that connects AI agents to locally computed astronomy-based astrology calculations. Its main tools generate natal charts, transits, progressions, synastry, composite charts, returns, Moon phases, eclipses, retrograde periods, sign ingresses, planetary positions, and exact aspect times without API keys.

Install it with `npx -y auseklis` through an MCP client configuration. Claude Code uses `claude mcp add auseklis -- npx -y auseklis`; Claude Desktop and other stdio clients can register `npx` with `-y` and `auseklis` as the arguments.

Yes, it can work with Cursor as a standard MCP server, provided Cursor is configured to launch the stdio command or connect to the Streamable HTTP deployment. The project does not describe a Cursor-specific setup or require an API key.

No, local operation does not require an API key or additional configuration. The ephemeris is computed locally. A self-hosted remote deployment can optionally set `MCP_SHARED_SECRET` to require bearer-token authentication.

No, Chiron and asteroids are not currently supported. The project avoids external ephemeris data files, and those bodies require additional data; public-domain JPL-derived data is listed as a future option.

Related MCP servers

All in Spirituality & Esoterica All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAuseklis Astrology AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/auseklis-astrology?style=directory)](https://allmcps.com/mcp/auseklis-astrology)
HTML Embed
<a href="https://allmcps.com/mcp/auseklis-astrology"><img src="https://allmcps.com/api/badge/auseklis-astrology?style=directory" alt="Auseklis Astrology on AllMCPs" /></a>