For AI agents · MCP server
Give Claude or ChatGPT a living sky to query.
Claude and ChatGPT already know how to hold a conversation. Now they can look up. Ask about tonight's sky, someone's chart, the next eclipse — and the answer comes from NASA JPL DE440, the ephemeris kernel used for spacecraft navigation, instead of being made up.
- things it can look up
- 92 tools
- things it can look up
- every number computed from it
- NASA JPL DE440
- every number computed from it
- to connect it
- One click
- to connect it
Draw my birth chart — March 21 1990, noon, London.
ephemeris_chart_wheel1.2sActual API output — not a mock-up
Connect Claude or ChatGPT
One connector, about thirty seconds. Signing in creates your free account — nothing to install.
Connect Claude or ChatGPT in ~30 seconds
One remote MCP connector, the same URL for both. No download, no API key — OAuth handles sign-in and creates your account on first connect. The interactive charts render inline in either one.
- 1Click "Add to Claude" — it copies the URL and opens Settings → Connectors.
- 2Click "Add custom connector" and paste the URL (Ctrl/⌘+V).
- 3Leave the OAuth Client ID and Secret blank, click "Add", and approve the sign-in — that also creates your free OpenEphemeris account.
- 1Turn on Settings → Plugins → Advanced → Developer mode (one time only).
- 2Click "Open ChatGPT" — it copies the URL and opens the plugins page. Click "+ Create app".
- 3Paste the URL, leave Authentication on OAuth, tick the box and click Create. Approve the sign-in — that also creates your free OpenEphemeris account.
Custom connectors on claude.ai require a paid Claude plan (Pro or higher); on the Claude desktop app and Claude Code, all plans work. ChatGPT developer mode was available on a Free plan when last checked (4 Sep 2026). OpenEphemeris is not listed in the ChatGPT app directory, so you add it yourself.
Using Claude Desktop, Cursor, or another client? See all setup options →
On Claude's free plan? Use the Claude Desktop config below — every plan works there.
Your birth data never trains a model — we don't sell it, share it, or feed it to anyone. Privacy policy
Say it plainly. It handles the rest.
You ask in your own words. Claude or ChatGPT picks the right tool, sends the right parameters, and answers from computed data.
“What's in the sky right now?”
A live snapshot of every planet, tonight.
current_sky_snapshot“Draw my birth chart.”
An interactive wheel you can click and explore.
explore_natal_chart“Are we actually compatible?”
Two charts, honestly compared.
ephemeris_synastry“Where on Earth am I luckiest?”
Your planetary lines drawn across the map.
acg_power_lines“Any big transits hitting me this month?”
Exact dates, not vague vibes.
ephemeris_natal_transits“What's my Human Design type?”
An interactive bodygraph — type, strategy, authority.
explore_human_design“When is the next eclipse?”
Down to the minute, anywhere on Earth.
ephemeris_next_eclipse“Read my Chinese four pillars.”
BaZi chart with Ten Gods and luck pillars.
chinese_baziFree to start. Pennies to keep going.
Every account starts with 150 free credits — about 150 natal charts, no card. Richer questions cost more credits (synastry 3, maps 10). When they run low, top up your wallet for a few dollars. No subscription, no monthly bill. Credits never expire.
Pay only for what you use
Using a different client?
All 92 tools work in Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT, and any MCP-compatible client — one build, one server. In Claude and ChatGPT the charts render inline; elsewhere the same data arrives as text.
{
"mcpServers": {
"openephemeris": {
"command": "npx",
"args": ["-y", "@openephemeris/mcp-server"]
}
}
}Settings → Developer → Edit Config. Paste, save, restart. No API key required — first tool call prompts you to link your account.
Self-hosted and CLI clients authenticate with an API key from your dashboard. Free Explorer tier — 150 credits to start (one-time), no card required.
Your client will list about 36 tools, not 92
That's on purpose. A long tool list eats context and makes assistants pick badly, so a fresh connection advertises a focused everyday set — one interactive app per tradition, the main data tool per domain, and geocoding. Nothing is removed: all 92 tools stay callable by name, and dev_list_allowed lists what else is reachable.
New: work in one tradition? Ask for it by name and pay a fraction of the context — ?profile=hd advertises Human Design in full at ~60% fewer tokens per message than the default set. Combine with commas (hd,bazi):
Want everything advertised up front? Ask for the full catalog:
- Local (npx):
OPENEPHEMERIS_TOOLS=fullin the server'senvblock - Hosted URL:
https://mcp.openephemeris.com/mcp?profile=full
The surface is fixed when the session starts — reconnect after changing it.
Frequently Asked Questions
What is an astrology MCP server?+
An MCP (Model Context Protocol) server is a connector that gives AI assistants callable tools. The OpenEphemeris MCP server carries 92 astrology tools — natal charts, transits, synastry, astrocartography, Human Design, and BaZi — so your assistant answers from real computed data backed by NASA JPL DE440 instead of guessing.
How do I connect Claude or ChatGPT to real astrology data?+
On claude.ai, add the OpenEphemeris connector in one click — signing in creates your free account, nothing to install. On Claude Desktop, paste a short JSON config; in Claude Code, run one terminal command. In ChatGPT, turn on developer mode under Settings → Plugins → Advanced, then use + Create app on chatgpt.com/plugins with the URL https://mcp.openephemeris.com/mcp and Authentication set to OAuth — there is no client ID or secret to enter. Your first tool call prompts you to link your account — no API key needed to start.
Does it work with ChatGPT, Cursor, and other MCP clients?+
Yes. All 92 tools work in Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT, and any MCP-compatible client — one build serves all of them. The interactive chart apps render inline in both Claude and ChatGPT; other clients receive the same computed data as text. Clients that accept a hosted MCP URL connect to mcp.openephemeris.com/mcp with an API key in the X-API-Key header.
Why does my client only list about 36 tools?+
That is the default tool surface, and it is deliberate. A connection advertises about 36 everyday tools — one interactive app per tradition, the main data tool per domain, geocoding — because a shorter list makes the assistant pick better. Nothing is removed: all 92 tools stay callable by name, and dev_list_allowed enumerates the rest. To advertise the whole catalog, run the package with OPENEPHEMERIS_TOOLS=full, or add ?profile=full to the hosted URL. You can also scope the surface to a tradition — ?profile=hd, or a comma list like hd,bazi — and pay a fraction of the context for that tradition covered in full.
Is there a free trial?+
Yes. Every account starts with 150 free trial credits — about 150 natal charts — no credit card required. Credits never expire, and you can top up your wallet from $5 when they run low.
Want the full story? Read the connector announcement.