Auseklis Astrology MCP Server

Astrology from a real ephemeris: natal charts, transits, synastry, eclipses, returns. No API keys.

Remote serverstreamable-http

What is the Auseklis Astrology MCP server?

Auseklis Astrology MCP server is a hosted integration for AI assistants that speak the Model Context Protocol. Astrology from a real ephemeris: natal charts, transits, synastry, eclipses, returns. No API keys.

What you get

Named after the Latvian morning star. MIT-licensed with no AGPL ephemeris data — see Licensing.

What the assistant can call

Once Auseklis Astrology is connected, these are the calls the assistant has available:

  • 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?")

Setting it up

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

Configuration and credentials

You will need one environment variable: MCP_SHARED_SECRET. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Choosing this one

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Auseklis Astrology's toolset — get_planet_position, compute_natal_chart, compute_transits and 9 more — is a fair guide to whether it matches your workflow. It is maintained by igmizo; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 12 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Auseklis Astrology.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the auseklis astrology mcp server does with a few real requests.

Available tools

ToolWhat it does
get_planet_positionPosition of one body/point at a moment (sign, degree, speed, retrograde)
compute_natal_chartFull birth chart: 13 points, houses, angles, Part of Fortune, aspects
compute_transitsAspects from the current (or any) sky to a natal chart
compute_progressionsSecondary progressions (day-for-a-year)
compute_synastryCross-chart aspects between two people
compute_composite_chartMidpoint composite chart of a relationship
find_returnsSolar/lunar/planetary returns (exact moments)
get_moon_phasePhase, illumination, Moon sign, next four quarters
find_eclipsesLunar/solar eclipses with signs, incl. local visibility
find_retrograde_periodsStation retrograde/direct moments for any planet
find_sign_ingressesWhen a body changes signs (equinoxes, Saturn ingresses, …)
find_aspect_timesExact moment a transit perfects ("when does Saturn square my Sun?")

How to install the Auseklis Astrology MCP server

{
  "mcpServers": {
    "auseklis": {
      "command": "npx",
      "args": ["-y", "auseklis"],
      "env": {
        "MCP_SHARED_SECRET": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
MCP_SHARED_SECRETCredential the server authenticates with.Yes

Example prompts to try

  • Use Auseklis Astrology to get planet position.
  • Use Auseklis Astrology to compute natal chart.
  • Use Auseklis Astrology to compute transits.

Frequently asked questions

It connects Auseklis Astrology to MCP-compatible AI assistants such as Claude and Cursor, exposing 12 tools (get_planet_position, compute_natal_chart, compute_transits, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Auseklis Astrology directly.