Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Open Ephemeris

✓ service owner · openephemeris.com

by openephemerisversion 4.33.0i★ 5iRuns in the cloudOfficial site ↗
Registry namecom.openephemeris/open-ephemeris

How to install

What it does

Astrology app for ChatGPT and Claude: real charts from NASA JPL DE440, not AI guesses.

  • Connects Runs in the cloud
  • Account or key Sign in to the service when you connect (OAuth)
  • Category Astrology & auspicious dates

Why it ranks here

This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order

1. In Claude’s connector directoryNo
2. Tried by our teamNo
3. Works for Thai usersNo
4. Usage without stars20/100Popularity 0 · Freshness 12 · Still answering 8 · Likes from users +0
5. Listed on2026-11-16

Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.

Quality: Passed 4/4 basic checks (shown, not used for ordering)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Open Ephemeris. Follow https://mcp.popnx.com/i/openephemeris-open-ephemeris.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 4/4 checks · What you ask goes through the maker’s server (mcp.openephemeris.com) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameOpen Ephemeris
    Remote MCP server URL · Addresshttps://mcp.openephemeris.com/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsOpen Ephemeris

  4. Try it

    Use Open Ephemeris and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Open Ephemeris or shows a Open Ephemeris tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameOpen Ephemeris
    Connection · Addresshttps://mcp.openephemeris.com/mcp
  3. Pick Open Ephemeris in a chat

    Start a new chat and pick Open Ephemeris from your plugins before typing

  4. Try it

    Use Open Ephemeris and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Open Ephemeris or shows a Open Ephemeris tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user open-ephemeris https://mcp.openephemeris.com/mcp
  3. Type /mcp in Claude Code

    You should see Open Ephemeris listed as connected

  4. Try it

    Use Open Ephemeris and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Open Ephemeris or shows a Open Ephemeris tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Open Ephemeris and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Open Ephemeris or shows a Open Ephemeris tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Open Ephemeris and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Open Ephemeris or shows a Open Ephemeris tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://mcp.openephemeris.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Open Ephemeris💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Verified domain
✓ openephemeris.com
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
4.33.0
Published to registryi
Nov 16, 2026
Code last changedi
Nov 16, 2026
Last checked
Nov 19, 2026
Maker
openephemeris
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

The server asks you to sign in before it lists its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain openephemeris.com (the registry checks domain ownership)

  • ✓ Pass

    Still maintained

    Code last changed 3 days ago

  • – Not applicable

    Has a licence

    Not applicable: a cloud server run by the owner of openephemeris.com; you don't run code from the repo

  • ✓ Pass

    Endpoint responds

    Responded in 278 ms (HTTP 401)

  • ✓ Pass

    Sign-in with OAuth

    Declares OAuth sign-in, so your AI app can take you to log in

  • … Not checked yet

    No hidden instructions in tool descriptions

    Not checked yet; we read the tool list when we check the endpoint

The cloud address answered 5 of the last 5 checks · latest 278 ms · checked Nov 19, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/openephemeris-open-ephemeris.svg)](https://mcp.popnx.com/en/servers/openephemeris-open-ephemeris)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Astrology & auspicious datesi

  • More stars than 96% of the other 128 servers in this category
  • Published to the registry more recently than 95% of the other 128 servers in this category
  • Basic checks equal to or better than 99% of the other 128 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Open Ephemeris safe?

It passed 4 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 3 days ago, and the latest version (4.33.0) reached the registry 3 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: NatalChart.AI Astrology, Asteria: Astrology & Tarot, Zodiacs, Marselia, AskY Tarot Reading

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Zodiacs

Astrology with planet positions tested against NASA JPL Horizons: charts, compatibility, horoscopes.

by zodiacs-orgEarly★ 0Updated 2 days ago

Runs in the cloud✓ service owner · zodiacs.org

Marselia

Tarot de Marseille reference: 78 sourced cards, tarot decks, Academy lessons and a random card draw.

by marselia.appEarlyUpdated 3 days ago

Runs in the cloud✓ service owner · marselia.app
Compared with similar ones
This one
Open Ephemeris
NatalChart.AI AstrologyAsteria: Astrology & TarotZodiacsMarseliaAskY Tarot Reading
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks4/42/34/44/42/32/3
LicenseMIT––NOASSERTION––
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Open Ephemeris MCP Server

Astrology that works inside ChatGPT and Claude: real computed charts from NASA JPL DE440, not AI guesses.

Use it in Claude: add https://mcp.openephemeris.com/mcp as a custom connector (leave the OAuth Client ID and Secret blank) or install the Open Ephemeris plugin from the Claude directory. Sign-in happens in the browser and creates a free account with 150 credits.

Model Context Protocol server for Open Ephemeris — typed astrology tools powered by the NASA JPL DE440 ephemeris. Zero hallucination on planetary positions, dates, and degrees. Covers 1,100 years of astronomical data.

Hosted endpoint: https://mcp.openephemeris.com/mcp (Streamable HTTP, MCP 2025-11-25 spec)

Quick Start

Quick install

Claude Code, one command:

claude mcp add openephemeris -- npx -y @openephemeris/mcp-server

Any client that takes a hosted URL (Claude Web, ChatGPT, custom agents): use https://mcp.openephemeris.com/mcp and send your API key in the X-API-Key header. Other clients are below.


Connect from code (Streamable HTTP)
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"

import { Client } from "@modelcontextprotocol/sdk/client/index.js"

const transport = new StreamableHTTPClientTransport( new URL("https://mcp.openephemeris.com/mcp"), { requestInit: { headers: { "X-API-Key": "your-openephemeris-api-key" } } } )

const client = new Client({ name: "my-app", version: "1.0.0" }, { capabilities: {} }) await client.connect(transport)


One-click install (Cursor)

Replace YOUR_API_KEY_HERE in Cursor MCP settings with your API key from https://openephemeris.com/dashboard.

Cursor deeplink payload:

{

"command": "npx", "args": [ "-y", "@openephemeris/mcp-server" ], "env": { "OPENEPHEMERIS_PROFILE": "dev", "OPENEPHEMERIS_BACKEND_URL": "https://api.openephemeris.com", "OPENEPHEMERIS_API_KEY": "YOUR_API_KEY_HERE" } }

<!-- GENERATED:CURSOR_INSTALL:END -->
Manual install (stdio MCP clients)
{

"mcpServers": { "openephemeris": { "command": "npx", "args": ["-y", "@openephemeris/mcp-server"], "env": { "OPENEPHEMERIS_PROFILE": "dev", "OPENEPHEMERIS_BACKEND_URL": "https://api.openephemeris.com", "OPENEPHEMERIS_API_KEY": "YOUR_API_KEY_HERE" } } } }

Platform guide

Detailed setup walkthroughs for each platform are in SETUP.md.

ClientInstall modeConfig location
Claude CodeCLIclaude mcp add openephemeris -- npx -y @openephemeris/mcp-server
CursorOne-click deeplink or manual~/.cursor/mcp.json
Claude Desktop (macOS)Manual~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)Manual%APPDATA%\Claude\claude_desktop_config.json
WindsurfManual~/.codeium/windsurf/mcp_config.json (or legacy ~/.codeium/mcp_config.json)
ChatGPTOne-clickOpen Ephemeris in the ChatGPT app directory
Claude Web / remote clientsHosted URLhttps://mcp.openephemeris.com/mcp
Client install walkthroughs
  1. Cursor
  • Click the "Install in Cursor" button above, then replace YOUR_API_KEY_HERE in Cursor MCP settings.
  • If you prefer manual setup, paste the mcpServers.openephemeris block from "Manual install" into ~/.cursor/mcp.json.
  1. Claude Desktop (macOS/Windows)
  • Open the platform config file from the table above.
  • Add the same mcpServers.openephemeris block from "Manual install".
  • Restart Claude Desktop.
  1. Windsurf
  • Open ~/.codeium/windsurf/mcp_config.json (or the legacy ~/.codeium/mcp_config.json path).
  • Add the mcpServers.openephemeris block from "Manual install".
  • Restart Windsurf.
Remote-only clients (Claude Web, ChatGPT, etc.)

The server is hosted at https://mcp.openephemeris.com/mcp with full Streamable HTTP support (MCP 2025-11-25 spec). Remote-only clients can connect directly — no bridge/proxy required:

  • Claude Web: Add https://mcp.openephemeris.com/mcp as a custom connector URL — leave OAuth Client ID and Secret blank. The server uses OAuth 2.1 + PKCE (Dynamic Client Registration), so Claude handles authentication via a browser popup automatically.
  • ChatGPT: Open Ephemeris is an approved app in the ChatGPT app directory. Open the listing, click Install plugin, approve the sign-in (that also creates your free Open Ephemeris account), then type @Open Ephemeris in any chat. Charts render inline, exactly as they do in Claude. Prefer to wire it yourself? Settings → Plugins → Advanced → Developer mode → + Create app accepts https://mcp.openephemeris.com/mcp with Authentication on OAuth — no client ID or secret to enter.
  • Legacy SSE: retired in 3.20.0 — use Streamable HTTP at /mcp
Auth and upgrade behavior in MCP clients
  • Missing/invalid credentials (401): tool call fails with a message that points users to sign up/sign in at https://openephemeris.com/login?signup=true&redirect=%2Fdashboard%3Ftab%3Daccount, then create/manage keys in https://openephemeris.com/dashboard?tab=account.
  • Tier-gated endpoint (403): tool call returns an upgrade-required message with https://openephemeris.com/pay and dashboard billing/key management link.
  • Out of credits (402): tool call returns a one-tap top-up link (Explorer's 150 free credits are one-time and do not reset; plan allowances renew each billing period) plus the dashboard usage link. Failed calls (any 4xx/5xx) are refunded.
  • Burst/rate limit (429): tool call returns retry guidance and links to dashboard usage monitoring.

What You Can Ask

"Calculate a natal chart for 1990-04-15 at 2:30 PM in Chicago."

"Find all Saturn transits to my natal Sun in the next 6 months." "Get the current moon phase and void-of-course status." "Find the next solar eclipse visible from Tokyo." "Find the best time to sign a contract in March — electional window." "Generate a Human Design chart for my birth data." "What is my Vedic (sidereal) chart?" "Calculate my Chinese BaZi (Four Pillars) chart." "Show me my Astrocartography power lines — where is my Venus line on the map?" "Find all ACG lines within 3° of Paris for my chart." "Calculate a synastry chart between two people." "Find the next Venus Star Point and my relationship to it." "What are the active planetary stations in the next 3 months?" "Calculate primary directions for the next 5 years." "Find my Firdaria time lord period." "What is the sidereal time and delta-T right now?"

Interactive Charts

Nine of the tools don't answer with JSON. They open a chart in the conversation — a real one, drawn from the same calculation, that you can click around in.

This matters more than it sounds. A natal chart returned as JSON is a list of numbers you have to already understand to read. The same chart rendered as a wheel is something you can point at. Click a planet and you get that placement explained; click a house and you get what's in it. The chart stays on screen while you keep talking, and it doesn't cost another credit to keep looking at it.

These need a host that supports MCP Apps. Claude and ChatGPT both do, and they render the same widget — there is no separate ChatGPT build. MCP Apps (SEP-1865) was co-authored by Anthropic and OpenAI and became the first official MCP extension in January 2026, so one ui:// resource serves both. In ChatGPT, install it from the app directory; in Claude, add the connector (see SETUP.md).

In a client without app support the same tools still work; you get the underlying data instead of the picture, so nothing breaks, you just don't get the wheel.

ToolWhat opensWhat you can clickCredits
explore_natal_chartNatal wheel — planets, houses, aspects, anglesPlanets, houses, aspect lines; recalculate with new settings1
explore_bi_wheelTwo charts on one wheel: transits, synastry, progressionsEither wheel's planets, houses, and the aspects between them2 (6 for solar/lunar return)
explore_human_designHuman Design bodygraph, with a mandala view toggleCenters, gates, channels, planets, variables4
explore_human_design_transitToday's planets laid over a natal bodygraphTransit-activated channels5
explore_human_design_connectionTwo bodygraphs combined, every shared channel classifiedConnection channels by type5
explore_vedic_chartSouth Indian Rashi grid — sidereal placements and LagnaEach rashi, for its placements and nakshatras3
explore_bazi_chartFour Pillars (四柱命盘) — Year, Month, Day, HourEach pillar3
explore_transit_timelineUpcoming transit hits in date orderIndividual hits6 for up to 1 year (priced by span)
explore_moon_phaseMoon dial — illumination, phase, sign, void-of-courseRecalculate for another moment3
explore_time_lordsZodiacal releasing from Spirit and Fortune over the whole life, the profection wheel, firdaria and the next changesSpirit or Fortune; any level 1 period, to see its level 2 periods, peaks and Loosing of the Bond9
ephemeris_electionalThe best timing windows in a range; with 1-8 people's births, a date that works for all of them: candidate windows on a timeline (best three starred), each person's good and vetoed hours and why, and ranked windows with each person's breakdown. Pro; in coreAny window, for its best hour and why it works for each person; "Ask about this window"9 for 1-2 people over a month (+1 per extra person; longer spans more); 5 with no people

Ask for these the way you'd ask a person: *"show me my chart"*, *"put today's transits over my Human Design"*, *"what's the moon doing right now"*. The model picks the app.

Two things worth knowing. The chart wheel and bi-wheel accept a click on an aspect line, not just on the two planets it joins — so "why does this line matter" is one click rather than a paragraph of setup. And the bodygraph's mandala toggle rearranges the whole chart into concentric rings without another API call, so switching views is free.

Tools at a Glance

| Category | Tool

Only the beginning is shown; read the rest in the repo