# Open Ephemeris

> Open Ephemeris is a freemium MCP server for astrology. Astrology charts computed from NASA JPL DE440 data for Claude, ChatGPT and other clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web, CLI
- **Website:** https://openephemeris.com/astrology-mcp
- **Repository:** https://github.com/openephemeris/openephemeris-mcp
- **MCP Registry name:** com.openephemeris/open-ephemeris
- **Categories:** astrology
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.openephemeris.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/open-ephemeris
