Skip to content
MCP server

Open Ephemeris

Astrology charts computed from NASA JPL DE440 data for Claude, ChatGPT and other clients

Pricing
Freemium
Platforms
API, Web, CLI
Runs
Remotely
Version
4.33.0
Listing updated
1 day ago

About Open Ephemeris

Open Ephemeris is a freemium MCP server for astrology. It runs as a hosted remote server, so there is nothing to install locally.

Numbers come from an ephemeris calculation rather than model recall. The docs cite the NASA JPL DE440 kernel, covering about 1,100 years, and say the server exposes 104 tools. The site reports a test of 210 birth dates in which Claude alone declined 40 and got a planet in the wrong sign in 169 of the rest, with the server connected, 209 of 210 charts were fully right.

Questions cover natal charts, live sky snapshots, synastry, transits, planetary lines on a map, eclipses, wedding-date windows, Human Design bodygraphs, zodiacal releasing with profections and firdaria, and Chinese BaZi. In Claude and ChatGPT the charts render inline as interactive graphics; elsewhere the same data arrives as text.

It connects as a remote server at mcp.openephemeris.com with OAuth sign-in that creates a free account, or locally with npx @openephemeris/mcp-server using an API key. The site says birth data never trains a model and is not sold or shared.

Install

Run in a terminal

claude mcp add --transport http open-ephemeris https://mcp.openephemeris.com/mcp

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "open-ephemeris": {
      "type": "http",
      "url": "https://mcp.openephemeris.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "open-ephemeris": {
      "serverUrl": "https://mcp.openephemeris.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "open-ephemeris": {
      "type": "http",
      "url": "https://mcp.openephemeris.com/mcp"
    }
  }
}

What it does

JPL DE440 calculations
Positions and dates come from the ephemeris, not from model guesses.
104 tools
Covers natal, synastry, transits, maps, eclipses and more.
Human Design bodygraph
Returns type, strategy and authority as an interactive chart.
Time-lord timelines
Zodiacal releasing, profections and firdaria on one timeline.
Chinese BaZi
Four pillars with Ten Gods and luck pillars.
Inline interactive charts
Render in Claude and ChatGPT; plain text elsewhere.
OAuth or API key
Browser sign-in for remote use, key for self-hosted and CLI clients.

Good for

  • Draw a birth chart from a date, time and place
  • Check transits hitting a chart this month
  • Compare two charts for compatibility
  • Find ranked wedding date windows
  • Look up the next eclipse for a location

Pricing

Freemium

150 free credits with no card; pay-as-you-go top-ups, no subscription

Prices change. Check openephemeris.com before you buy.

Open Ephemeris FAQ

How much does it cost to start?

Each account starts with 150 free credits, about 150 natal charts, no card.

Is there a subscription?

The site says no: top up a wallet and credits never expire.

What do richer questions cost?

Examples given: synastry 3 credits, maps 10.

Which clients work?

Claude, ChatGPT, Claude Desktop, Claude Code, Cursor, Windsurf and any MCP client.

Do custom connectors need a paid Claude plan?

On claude.ai yes (Pro or higher); Claude Desktop and Claude Code work on all plans.

Is Open Ephemeris free?

Open Ephemeris has a free plan, with paid plans for more usage or features.

How do I add Open Ephemeris to Claude Code?

Run this command in your terminal: claude mcp add --transport http open-ephemeris https://mcp.openephemeris.com/mcp

What are the best alternatives to Open Ephemeris?

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

Alternatives to Open Ephemeris

  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