Skip to content
MCP server

Stellara MCP

Swiss Ephemeris natal charts, transits and synastry as exact JSON for AI agents

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.2.2
Listing updated
1 day ago

About Stellara MCP

Stellara MCP is a freemium MCP server for astrology. It can run locally on your machine or as a hosted remote server.

This server gives an assistant a calculator for astrology so it does not guess planetary positions. Four tools run on Swiss Ephemeris in the Stellara cloud: resolving a birth place, calculating a natal chart, computing transits and aspects, and calculating synastry between two people. The server itself does not interpret anything or call an LLM; the assistant reads the returned JSON.

resolve_birth_place turns a place and time into coordinates, an IANA timezone and a datetime with the historically correct UTC offset. The natal chart covers 14 points, 12 house cusps, the angles and every major aspect with exact orb and applying or separating state. Two MCP prompts help gather a birth profile and set a professional astrologer style.

It can be used remotely by URL with a Stellara account sign-in, or locally through the npm package with an API key. The README lists a free tier of 10 requests a day and 5,000 on Stellara Pro.

Install

Run in a terminal

claude mcp add --transport http stellara-mcp https://mcp.stellara.natlex.it/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.stellara.natlex.it/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "stellara-mcp": {
      "url": "https://mcp.stellara.natlex.it/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "stellara-mcp": {
      "type": "http",
      "url": "https://mcp.stellara.natlex.it/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "stellara-mcp": {
      "serverUrl": "https://mcp.stellara.natlex.it/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "stellara-mcp": {
      "type": "http",
      "url": "https://mcp.stellara.natlex.it/mcp"
    }
  }
}

Configuration

  • STELLARA_API_KEYStellara API access key (request at https://stellara.natlex.it/#api)Required
  • STELLARA_API_BASE_URLOverride the API base URL (default https://api.stellara.natlex.it/api/v1/astrology)

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

resolve_birth_place
Resolve a place and time to coordinates, timezone and UTC offset.
calculate_natal_chart
Compute 14 points, house cusps, angles and aspects.
get_transits_and_aspects
Transiting positions and aspects to the natal chart.
calculate_synastry
Inter-chart aspects and house overlays between two people.

What it does

Birth place resolution
Maps a city and time to coordinates, timezone and correct historical UTC offset.
Natal charts
14 points, 12 house cusps, angles and aspects with exact orbs.
Transits
Transiting positions and transit-to-natal aspects at any moment.
Synastry
Inter-chart aspects and house overlays for two people.
Guided prompts
A birth-data intake prompt and an astrologer system prompt.
Remote or local
Connect by URL or run the npm package with an API key.

Good for

  • Have an assistant cast an accurate natal chart
  • Check today's transits against a natal chart
  • Compare two people's charts
  • Ground astrology chats in computed data

Pricing

Freemium

Free 10 requests/day; Stellara Pro 5,000 requests/day

Prices change. Check stellara.natlex.it before you buy.

Stellara MCP FAQ

Does the server write the readings?

No. It returns numbers only; the connected assistant does the interpretation.

What are the usage limits?

The README lists 10 requests per day on the free plan and 5,000 on Stellara Pro.

How do I connect?

Add the remote URL as a connector and sign in, or install the stellara-mcp npm package with an API key.

Is Stellara MCP free?

Stellara MCP has a free plan, with paid plans for more usage or features.

How do I add Stellara MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http stellara-mcp https://mcp.stellara.natlex.it/mcp

What are the best alternatives to Stellara MCP?

The closest alternatives to Stellara MCP are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.

Alternatives to Stellara MCP

  1. Natal Chart Lab

    MCP server

    Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements

    Runs locally
    • 5 tools
    • Open source
    • Astrology
  2. AstroLogics

    MCP server

    Vedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching

    • 23 tools
    • Remote
    • Freemium
    • Astrology
  3. Céu Natal

    MCP server

    Swiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese

    • 9 tools
    • Remote
    • Open source
    • Astrology
  4. Deterministic Korean tax, payroll, labor and calendar calculators served over MCP

    • 76 tools
    • Remote
    • Free
    • Finance and payments