Skip to main content
Glama

Open Ephemeris MCP Server

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

npm version System Status License: MIT Ephemeris: JPL DE440

Open Ephemeris in Claude — ask in plain language, get a real computed chart

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.

The catalog: 90 bodies and 124 fixed stars — asteroids, trans-Neptunians, Uranian points, computed in one engine

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)

Install in 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"
  }
}

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.

Client

Install mode

Config location

Claude Code

CLI

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

Cursor

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

Windsurf

Manual

~/.codeium/windsurf/mcp_config.json (or legacy ~/.codeium/mcp_config.json)

ChatGPT

One-click

Open Ephemeris in the ChatGPT app directory

Claude Web / remote clients

Hosted URL

https://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.

  2. 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.

  3. 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.

Related MCP server: Ziwei Astrology MCP Server

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.

Tool

What opens

What you can click

Credits

explore_natal_chart

Natal wheel — planets, houses, aspects, angles

Planets, houses, aspect lines; recalculate with new settings

1

explore_bi_wheel

Two charts on one wheel: transits, synastry, progressions

Either wheel's planets, houses, and the aspects between them

2 (6 for solar/lunar return)

explore_human_design

Human Design bodygraph, with a mandala view toggle

Centers, gates, channels, planets, variables

4

explore_human_design_transit

Today's planets laid over a natal bodygraph

Transit-activated channels

5

explore_human_design_connection

Two bodygraphs combined, every shared channel classified

Connection channels by type

5

explore_vedic_chart

South Indian Rashi grid — sidereal placements and Lagna

Each rashi, for its placements and nakshatras

3

explore_bazi_chart

Four Pillars (四柱命盘) — Year, Month, Day, Hour

Each pillar

3

explore_transit_timeline

Upcoming transit hits in date order

Individual hits

6 for up to 1 year (priced by span)

explore_moon_phase

Moon dial — illumination, phase, sign, void-of-course

Recalculate for another moment

3

explore_time_lords

Zodiacal releasing from Spirit and Fortune over the whole life, the profection wheel, firdaria and the next changes

Spirit or Fortune; any level 1 period, to see its level 2 periods, peaks and Loosing of the Bond

9

ephemeris_electional

The 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 core

Any 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

Tier

Natal chart

ephemeris_natal_chart

Explorer

Transit forecast

ephemeris_transits

Explorer

Transit chart snapshot

ephemeris_natal_transits

Explorer

Sign ingresses / planet to degree

ephemeris_ingresses

Explorer

Moon phase / VOC

ephemeris_moon_phase

Explorer

Eclipse next visible

ephemeris_next_eclipse

Explorer

Electional window

ephemeris_electional

Pro

Moment analysis

electional_moment_analysis

Explorer

Station tracker

electional_station_tracker

Explorer

Aspect search

electional_aspect_search

Pro

Human Design chart

human_design_chart

Explorer

HD composite

human_design_composite

Explorer

HD transit overlay

explore_human_design_transit

Explorer

HD transit timeline (gates over a date range)

human_design_transit_timeline

Explorer

HD extended placements (asteroids, angles, lots, stars)

human_design_extended

Explorer (deep fields Pro)

HD connection (synastry)

explore_human_design_connection

Explorer

HD penta

human_design_penta

Explorer

HD return / opposition

hd_planetary_return, hd_opposition

Explorer

Vedic chart

vedic_chart

Explorer

BaZi (Chinese)

chinese_bazi

Explorer

Synastry

ephemeris_synastry

Explorer

Composite chart

ephemeris_composite

Explorer

Relocation chart

ephemeris_relocation

Explorer

Progressed chart

ephemeris_progressed_chart

Explorer

Solar return

ephemeris_solar_return

Explorer

Lunar return

ephemeris_lunar_return

Explorer

Planetary return

ephemeris_planetary_return

Explorer

Astrocartography lines

acg_power_lines

Pro

ACG hits at location

acg_hits

Pro

Venus Star Points

venus_star_points + 4 more

Explorer

Chart wheel image

ephemeris_chart_wheel

Explorer

Bi-wheel image

ephemeris_bi_wheel

Explorer

Dignities / Midpoints / Fixed stars

ephemeris_dignities, ephemeris_midpoints, ephemeris_fixed_stars

Explorer

Tooling Model

  • Typed tools are preferred for common workflows (natal, transits, moon phase, eclipse, synastry, relocation, electional, Human Design).

  • Generic tools: find_calculation searches the allowlisted operations by plain words and returns the path, inputs, an example and the credit cost (dev_list_allowed lists them all, outside core); dev_read_api invokes allowlisted GET (read) operations and dev_write_api invokes allowlisted POST/PUT/PATCH/DELETE (write/compute) operations, each by method + path. Read and write are kept as separate tools so a safe read surface never shares a tool with state-changing writes.

  • Security model: default-deny with explicit allowlist in config/dev-allowlist.json.

  • Deny prefixes block sensitive route families (/auth, /billing, /admin, etc.).

dev_read_api / dev_write_api input

Parameter

Type

Required

Description

method

dev_read_api: GET · dev_write_api: POST|PUT|PATCH|DELETE

No

HTTP method (defaults to the tool's natural method)

path

string

Yes

Absolute API path, e.g. /ephemeris/natal-chart

query

object

No

Query parameters

body

object

No

JSON body for non-GET requests

preset

full|simple

No

Convenience mapping to query.preset

format

json|llm|llm_v2

No

Convenience mapping to query.format (llm_v2 normalizes to llm)

output_mode

full|simple|llm|llm_v2

No

Legacy compatibility field

Environment Variables

Variable

Required

Description

OPENEPHEMERIS_API_KEY

Yes (unless service key/JWT used)

API key for Open Ephemeris

ASTROMCP_API_KEY

No

Legacy alias for OPENEPHEMERIS_API_KEY (checked as fallback)

OPENEPHEMERIS_BACKEND_URL

No

Defaults to https://api.openephemeris.com

OPENEPHEMERIS_PROFILE

No

dev by default

OPENEPHEMERIS_TOOLS

No

core (default) advertises a focused everyday tool set; full advertises every tool. See Tool surface

OPENEPHEMERIS_TELEMETRY

No

Set to 0/false/off to disable anonymous usage reporting. DO_NOT_TRACK=1 also works. See Telemetry

OPENEPHEMERIS_JWT

No

Bearer token auth

OPENEPHEMERIS_DEV_ALLOWLIST_PATH

No

Override allowlist file path

MCP_USER_ID

No

Per-instance user identifier

Legacy aliases (ASTROMCP_*, MERIDIAN_*) remain supported.

Telemetry

This server reports anonymous usage so we know which tools are worth maintaining and which are broken. Three events: session start, tool call, tool error.

What is sent: the tool name, how long it took, error status, the names of the tool's own options you set (e.g. datetime,timezone, never their values), for the two general API tools which listed endpoint and output format were used, which MCP client connected (e.g. Claude Desktop, Cursor) and its version, the server version, and a stable id for the session: a one-way SHA-256 prefix of your API key, or your account ID when you sign in with OAuth.

What is never sent: your API key or token, birth data, dates, names, coordinates, the values of any tool argument, or tool results. No request or response bodies, ever.

To turn it off — either works, checked before anything is sent:

OPENEPHEMERIS_TELEMETRY=0
# or the cross-tool standard
DO_NOT_TRACK=1

Tool surface

By default the server advertises a focused core set of everyday tools rather than the entire catalog. Large tool lists cost context and make model tool-selection worse, so the default is tuned for real conversations: one interactive app per tradition, the primary data tool per domain, geocoding, and the allowlist-gated generic proxy.

Nothing is removed. The surface is a filter on tools/list only — every tool stays registered and stays callable by name. If you know the tool you want, call it and it works, listed or not.

To advertise the full catalog:

OPENEPHEMERIS_TOOLS=full npx -y @openephemeris/mcp-server

On the remote HTTP server, append ?profile=full to the connector URL (or send X-OE-Tool-Surface: full):

https://mcp.openephemeris.com/mcp?profile=full

Toolsets by tradition

If you work in one tradition, ask for it by name instead of taking the general-purpose default. You get that tradition in full — including the long-tail tools the core set leaves out — for a fraction of the context.

OPENEPHEMERIS_TOOLS=hd npx -y @openephemeris/mcp-server        # Human Design
OPENEPHEMERIS_TOOLS=astrology,moon npx -y @openephemeris/mcp-server
https://mcp.openephemeris.com/mcp?profile=hd,bazi

Toolset

What it covers

Tools

Approx. tokens

astrology

Natal, transits, ingresses, synastry, progressions, returns, relocation, time lords, dignities, midpoints, lots, fixed stars, composites, birth-time sensitivity

39

18,050

hd

Human Design charts, transits and transit timeline, extended placements, connection charts, penta, bodygraph

19

8,500

bazi

Four Pillars, Ten Gods, element balance, luck pillars, compatibility, Zi Wei Dou Shu

16

8,100

electional

Timing windows, group timing, angle crossings, stations, moment analysis

13

4,950

acg

Astrocartography lines and hits

9

3,400

vedic

Jyotish Rashi chart, dashas, vargas, Ashtakoota matching

10

3,400

moon

Phases, void-of-course, eclipses

11

3,300

venus

Star points, phases, elongations, stations

13

3,200

mundane

Ingress and lunation charts, geodetic chart

9

2,600

—

core (default)

40

20,150

—

full

83

40,100

Every selection also includes geocoding (location_search, timezone_resolve), account_usage, and the allowlist-gated proxy — so a birthplace is always resolvable and nothing is stranded.

Combine with commas; unknown names are ignored rather than rejected, so a typo degrades to a smaller surface instead of a dead connector. As with core/full, this only filters tools/list — every tool remains callable by name.

Why it matters: tool definitions are re-sent to the model on every pass. astrology,moon advertises a few more tools than the default but costs ~700 fewer tokens per message and covers more of the tradition.

The surface is fixed when the session initializes — this server does not advertise tools.listChanged, so switching requires reconnecting. On every surface, find_calculation searches every operation reachable through the generic proxy.

Contributing & Support

  • Something wrong with a result? Open an issue — include the tool, your inputs, and what you expected.

  • Want to contribute? See CONTRIBUTING.md. Integration examples and new skills are the most useful things you can add.

  • Found a security problem? Please report it privately — see SECURITY.md.

  • Tools timing out? Check status.openephemeris.com first.

If this saved you from an LLM confidently inventing a Saturn position, a ⭐ helps other people find it.

This package is licensed under the MIT License. However, use of this package to access the Open Ephemeris API constitutes use of the Service and is governed by the Open Ephemeris Terms of Service. By using this package, you agree to those terms. See also the Privacy Policy and Acceptable Use Policy.

Development

The server source is maintained in a private monorepo; this repository holds the public docs, plugin, skills and examples. Bug reports and contributions are welcome — see CONTRIBUTING.md.

Architecture

┌─────────────────────────────────────────────────────────┐
│                    MCP Clients                          │
│  Codex · Gemini   · Claude Web · ChatGPT · Remote apps  │
└──────────────────┬──────────────────────────────────────┘
                   │ Streamable HTTP (MCP 2025-11-25)
                   │ https://mcp.openephemeris.com/mcp
                   │
┌─────────────────────────────────────────────────────────┐
│          Cursor · Claude Desktop · Windsurf             │
└──────────────────┬──────────────────────────────────────┘
                   │ stdio JSON-RPC
                   │ npx @openephemeris/mcp-server
                   │
              ┌────▼────────────────────┐
              │  openephemeris-mcp      │
              │  Node.js MCP Server     │
              │  typed tools            │
              │  auth: Key > JWT        │
              └────────────┬────────────┘
                           │ HTTPS
                           ▼
              ┌────────────────────────┐
              │  Open Ephemeris API    │
              │  api.openephemeris.com │
              │  NASA JPL DE440        │
              │  1,100 years of data   │
              └────────────────────────┘

Runtime Snapshot (Generated)

Generated by npm run sync:readme from config/dev-allowlist.json and the live tool registry.

  • Allowlisted operations: 147

  • Methods: GET=50, POST=97, PUT=0, PATCH=0, DELETE=0

  • Registered tools (OPENEPHEMERIS_PROFILE=dev): 111

  • Typed tools: account_usage, acg_hits, acg_power_lines, auth_login, auth_logout, auth_status, bazi_annual_pillar, bazi_chart, bazi_compatibility, bazi_element_balance, bazi_luck_pillars, bazi_recalculate, bazi_ten_gods, bi_wheel_on_cross_aspect_click, bi_wheel_on_house_click, bi_wheel_on_planet_click, bi_wheel_recalculate, bi_wheel_synopsis, bodygraph_recalculate, chart_wheel_on_aspect_click, chart_wheel_on_house_click, chart_wheel_on_planet_click, chart_wheel_recalculate, chinese_bazi, electional_angle_crossings, electional_aspect_search, electional_moment_analysis, electional_station_tracker, ephemeris_angles_points, ephemeris_aspect_check, ephemeris_bi_wheel, ephemeris_chart_wheel, ephemeris_composite, ephemeris_composite_midpoint, ephemeris_dignities, ephemeris_electional, ephemeris_fixed_stars, ephemeris_hermetic_lots, ephemeris_house_cusps, ephemeris_ingresses, ephemeris_lunar_return, ephemeris_midpoints, ephemeris_moon_phase, ephemeris_natal_batch, ephemeris_natal_chart, ephemeris_natal_transits, ephemeris_next_eclipse, ephemeris_next_lunar_phase, ephemeris_overlay, ephemeris_planet_position, ephemeris_planetary_return, ephemeris_progressed_chart, ephemeris_relocation, ephemeris_retrograde_status, ephemeris_solar_return, ephemeris_synastry, ephemeris_time_lords, ephemeris_time_sensitivity, ephemeris_transits, explore_bazi_chart, explore_bi_wheel, explore_human_design, explore_human_design_connection, explore_human_design_transit, explore_moon_phase, explore_natal_chart, explore_time_lords, explore_transit_timeline, explore_vedic_chart, geodetic_chart, hd_connection_matrix, hd_on_center_click, hd_on_channel_click, hd_on_connection_channel_click, hd_on_gate_click, hd_on_planet_click, hd_on_transit_channel_click, hd_on_variable_click, hd_opposition, hd_planetary_return, human_design_bodygraph, human_design_chart, human_design_composite, human_design_extended, human_design_penta, human_design_transit_timeline, location_search, moon_phase_recalculate, mundane_chart, sky_eclipse, sky_light, sky_milky_way, sky_moon, sky_rise_set, sky_tonight, sky_track, timezone_resolve, vedic_chart, vedic_chart_recalculate, vedic_matching, venus_eight_year_star, venus_elongations, venus_phase, venus_star_points, venus_star_points_conjunctions, venus_stations, ziwei_chart

  • Generic tools: dev_list_allowed, dev_read_api, dev_write_api, find_calculation

Allowlist Families

Family

Operations

Example

acg

14

POST /acg/aspects, POST /acg/ccg

calendar

3

GET /calendar/astrology/cross-quarter, GET /calendar/astrology/lunar-standstill

catalogs

3

GET /catalogs/bodies, GET /catalogs/fixed-stars

chinese

12

POST /chinese/bazi, POST /chinese/bazi/annual-pillar

comparative

5

POST /comparative/composite, POST /comparative/composite/midpoint

eclipse

6

GET /eclipse/besselian-elements, GET /eclipse/lunar/global

electional

7

GET /electional/angle-crossings, GET /electional/aspect-search

ephemeris

43

GET /ephemeris/agro/calendar, GET /ephemeris/agro/daily

health

2

GET /health, GET /health/detailed

human-design

11

POST /human-design/chart, POST /human-design/composite

location

2

GET /location/autocomplete, GET /location/reverse

mundane

1

POST /mundane/chart

predictive

14

POST /predictive/eclipses/natal-hits, POST /predictive/primary-directions

root

1

GET /

sky

5

GET /sky/circles, GET /sky/light-at

tidal

1

GET /tidal/forcing

time

6

GET /time/delta-t, GET /time/equation-of-time

timezone

3

GET /timezone/coverage, POST /timezone/lookup

vedic

5

POST /vedic/chart, POST /vedic/kp

visualization

3

POST /visualization/bi-wheel, POST /visualization/bodygraph

Why Open Ephemeris for AI Agents?

Most LLMs (like Claude and ChatGPT) struggle heavily with astronomical calculations (trigonometry, Julian date conversions, and planetary lookups). Open Ephemeris serves as a secure, remote math engine.

By pairing LLMs with the Open Ephemeris MCP server, your agents can instantly access:

  • Zero-hallucination coordinates: Direct, NASA JPL DE440 calculations covering 1550–2650 CE, within about a tenth of an arcsecond of JPL Horizons for modern dates.

  • LLM-optimized tokens (format=llm): We compress standard 25,000 token JSON chart responses into minimal text blocks, cutting your inference costs by 50–73% depending on endpoint.

  • Ready-to-use astrology layers: Built-in support for Astrocartography geoJSON lines, Hermetic Lots, Fixed Stars, and complex Human Design matrix generation.

Available Tools

44 tools
account_usageAccount UsageA
Read-onlyIdempotent
Inspect

Use this when the user asks 'how many credits do I have left', 'what's my usage this month', 'what plan am I on' or 'how do I upgrade or top up'. Returns plan tier, billing period, credits used / included / remaining, API calls and subscription status with renewal date.

CREDIT COST: 0.

Inputs: month.

acg_hitsAstrocartography Location HitsA
Read-onlyIdempotent
Inspect

Use this when the user asks 'is Tokyo good for me', 'where should I live according to my chart' or 'should I move to Austin'. Returns every astrocartography line (power and aspect lines) within radius_deg of a place, nearest first.

CREDIT COST: 10 credits per call. Pro tier.

Inputs: birth_datetime (required), birth_latitude (required), query_latitude (required), birth_longitude (required), +6 more.

acg_power_linesAstrocartography LinesA
Read-onlyIdempotent
Inspect

Use this when the user asks 'show my astrocartography map', 'where are my Jupiter lines' or wants the whole-world list of their lines. Returns each planet's MC, IC, AC and DC lines with sign and equator-crossing longitude (no map geometry).

CREDIT COST: 10 credits per call. Pro tier.

Inputs: birth_datetime (required), birth_latitude (required), birth_longitude (required), bodies, +5 more.

auth_loginConnect AccountAInspect

Use this when the user asks to 'connect', 'sign in', 'log in' or 'link my Open Ephemeris account'. Returns a verification URL and code for the user to enter in their browser; the server then receives credentials automatically and every call is billed to that account (tier, credits, rate limits).

Inputs: no named parameters.

auth_logoutDisconnect AccountA
DestructiveIdempotent
Inspect

Use this when the user asks to 'log out', 'sign out', 'disconnect' or 'switch accounts' on this MCP server. Returns confirmation that cached device-auth credentials were cleared; an API key set in the environment is not revoked.

Inputs: no named parameters.

auth_statusAuth StatusA
Read-onlyIdempotent
Inspect

Use this when the user asks 'am I logged in', 'which account is this connected to', 'how am I authenticated' or 'when does my token expire'. Returns whether the server is authenticated, the linked account, the method (API key, JWT, device auth) and token expiry.

Inputs: no named parameters.

bazi_annual_pillarBaZi Annual PillarA
Read-onlyIdempotent
Inspect

Use this when the user asks 'what element is the year of the Snake', 'what's the pillar, stem and branch or NaYin for my birth year' or 'what's the energy of this year' — a single-year lookup beyond the animal. Returns the year's Heavenly Stem, Earthly Branch, animal, element, polarity and NaYin for any year 1-9999.

CREDIT COST: 3 credits per call.

Inputs: year (required).

dev_read_apiAPI ReadA
Read-onlyIdempotent
Inspect

Use this when find_calculation returns a GET path (biodynamic days, tidal forcing, crescent visibility, catalogs). Returns the endpoint's JSON. Read-only; POST paths go to dev_write_api.

Target API: Open Ephemeris REST API (https://api.openephemeris.com), allowlisted paths only. format 'llm' = compact output. 4xx/5xx are refunded.

Inputs: path (required), body, query, format, +3 more.

dev_write_apiAPI Compute (POST)A
Read-onlyIdempotent
Inspect

Use this when find_calculation returns a POST path (KP, Varshaphal, the Chinese calendar, bounds, eclipses on a chart). Returns the endpoint's JSON. Stateless compute; GET paths go to dev_read_api.

Target API: Open Ephemeris REST API (https://api.openephemeris.com), allowlisted paths only. format 'llm' = compact output. 4xx/5xx are refunded.

Inputs: path (required), body, query, format, +3 more.

electional_moment_analysisMoment Quality AnalysisA
Read-onlyIdempotent
Inspect

Use this when the user asks 'is today a good day to …', 'what's the sky like today', 'what's the astrological weather', 'how is this date astrologically' — or has no birth data (it works with no arguments). Returns planet positions, aspects, void-of-course status, lunar phase, day ruler, sect and an overall electional score (0-100) for one moment.

CREDIT COST: 5 credits per call.

Inputs: date, format, latitude, longitude.

electional_station_trackerRetrograde Station TrackerA
Read-onlyIdempotent
Inspect

Use this when the user asks 'when does Mercury go retrograde', 'when does Mercury retrograde end', 'when does Pluto go direct' or 'Mercury retrograde dates for 2026'. Returns every retrograde and direct station, Mercury through Pluto, with time, longitude and sign; default the next 90 days, max one year.

CREDIT COST: 5 credits per call.

Inputs: format, planets, end_date, start_date.

ephemeris_angles_pointsAngles & PointsA
Read-onlyIdempotent
Inspect

Use this when the user asks 'where is my Vertex', 'what's my East Point / equatorial ascendant' or 'what are my chart angles' for a date, time and place. Returns ASC, MC, DSC, IC, Vertex and the Equatorial Ascendant/Descendant (also as east_point).

CREDIT COST: 1 credit per call.

Inputs: datetime (required), latitude (required), longitude (required), timezone.

ephemeris_aspect_checkAspect CheckA
Read-onlyIdempotent
Inspect

Use this when the user asks 'is 15° Aries square 18° Cancer', 'how many degrees apart are my Sun and Moon' or 'is this within orb'. Returns the separation between two ecliptic longitudes and any aspect within orb.

CREDIT COST: 1 credit per call.

Inputs: longitude_1 (required), longitude_2 (required), max_orb.

ephemeris_electionalElectional TimingA
Read-onlyIdempotent
Inspect

Use this when the user asks 'when should I launch / sign / marry', 'a good day next month', or wants a date good for several people ('a wedding date for both of us'). Add up to 8 people's births to score the hours against their charts too; that opens a timeline. Ask which hours of the day work if unsaid.

CREDIT COST: no people 5 / 8 / 12 for ≤30 / 60 / 120 days; with people 9 (1-2 people, ≤30 days), +1 per extra person, +3 ≤60 days, +7 ≤120. Pro; longest range Pro 30 days, Startup 60, Scale 120.

Inputs: end_date (required), start_date (required), people, combine, +9 more.

ephemeris_house_cuspsHouse CuspsA
Read-onlyIdempotent
Inspect

Use this when the user asks 'what are my house cusps', 'which sign is my 7th house', 'what's my Midheaven', 'show my houses in Whole Sign' or 'compare Placidus and Koch' — houses and angles only, for a date, time and place. Returns the twelve cusps and ASC/MC/DSC/IC for each requested system.

HOUSE SYSTEM CODES: P=Placidus, K=Koch, O=Porphyry, R=Regiomontanus, C=Campanus, E=Equal, W=Whole Sign.

CREDIT COST: 1 credit per call.

Inputs: datetime (required), latitude (required), longitude (required), timezone, +1 more.

ephemeris_ingressesSign IngressesA
Read-onlyIdempotent
Inspect

Use this when the user asks 'when does Saturn enter Aries', 'when does Mercury change signs', 'when is the Moon in Scorpio next', or when a planet reaches an exact degree. Returns each sign ingress (exact UTC time, signs left and entered, retrograde flag) or, with degree, each crossing of that longitude.

CREDIT COST: 5 credits; 1 when the only planet is the Moon (90 days at most).

Inputs: sign, degree, planets, end_date, +2 more.

ephemeris_moon_phaseMoon PhaseA
Read-onlyIdempotent
Inspect

Use this when the Moon's state is wanted as data for a specific moment — 'what phase was the Moon on my birthday', 'what sign was the Moon in on 12 May 1990', 'moon phase and illumination as numbers'. Returns phase name, illumination %, the Moon's sign and degree, and the next void-of-course window; omit datetime for right now.

CREDIT COST: 2 credits.

Inputs: datetime, latitude, timezone, longitude.

ephemeris_natal_chartNatal ChartA
Read-onlyIdempotent
Inspect

Use this when the user wants their natal / birth chart as data rather than a picture — 'give me my chart as JSON', 'list my natal aspects with orbs', 'what exact degree is my Ascendant', 'my placements as a table' — or as the input to a further calculation. Returns raw JSON: all major planets plus Chiron and the major asteroids (Ceres, Pallas, Juno, Vesta) — and, on request, any of ~90 more bodies via additional_objects (Eris, Sedna, Psyche, Fortuna and so on) — angles (ASC/MC/DSC/IC), house cusps, retrograde flags and the major aspect grid; format='llm' gives compact output. Takes coordinates, not a place name.

CREDIT COST: 1 credit per call.

Inputs: datetime (required), latitude (required), longitude (required), format, +14 more.

ephemeris_next_eclipseEclipse FinderA
Read-onlyIdempotent
Inspect

Use this when the user asks 'when is the next eclipse', 'when is the next solar / lunar eclipse' or 'is there an eclipse visible from Tokyo'. Returns the eclipse type, time of maximum, magnitude and totality duration; with latitude+longitude, local contact times and visibility.

CREDIT COST: 1 credit per call.

Inputs: eclipse_type (required), latitude, longitude, after_date.

ephemeris_next_lunar_phaseNext Lunar PhaseA
Read-onlyIdempotent
Inspect

Use this when the user asks 'when is the next full moon', 'when is the next new moon', 'what date is the next quarter moon' or 'list the next 3 full moons'. Returns the exact UTC time of each upcoming occurrence of the phase.

CREDIT COST: 2 credits per occurrence; count max 12.

Inputs: phase (required), count, after_date.

ephemeris_planet_positionPlanet PositionA
Read-onlyIdempotent
Inspect

Use this when the user asks 'where is Mars right now', 'what sign is the Moon in today', 'what's my sun sign / star sign' (planet_id=0; a bare birth date resolves to noon UTC, no location needed), 'where was Jupiter on my birthday', 'where is the North Node' — one body at one moment. Returns ecliptic longitude, latitude, distance, speed and retrograde flag.

PLANET IDS: 0=Sun, 1=Moon, 2=Mercury, 3=Venus, 4=Mars, 5=Jupiter, 6=Saturn, 7=Uranus, 8=Neptune, 9=Pluto, 10=North Node (Mean), 11=North Node (True), 12=Lilith (Mean), 15=Chiron, 17=Ceres, 18=Pallas, 19=Juno, 20=Vesta. NODES: id 10 is the mean North Node (mean-node polynomial); id 11 is the true North Node (osculating, referenced to the true ecliptic of date). There is no South Node id; the South Node longitude is a North Node longitude plus 180° (mod 360).

CREDIT COST: 1 credit per call.

Inputs: datetime (required), planet_id (required), latitude, timezone, +1 more.

ephemeris_progressed_chartProgressed ChartA
Read-onlyIdempotent
Inspect

Use this when the user asks 'what's my progressed chart', 'my secondary progressions', 'where is my progressed Moon right now' or 'my solar arc directions'. Returns progressed planet positions, house cusps, aspects and retrograde status for a target date — method = secondary (1 day = 1 year, default), solar_arc, tertiary or minor; converse counts backward.

CREDIT COST: 1 credit per call.

Inputs: birth_datetime (required), birth_latitude (required), birth_longitude (required), target_datetime (required), +6 more.

ephemeris_relocationRelocation ChartA
Read-onlyIdempotent
Inspect

Use this when the user asks 'how does my chart change if I move to London', 'what's my chart in Paris', 'my relocated Ascendant in Tokyo' or 'recast my chart for where I live now'. Returns the natal chart re-cast for a new location — the same planetary longitudes with the houses and angles that place gives them.

CREDIT COST: 1 credit per call.

Inputs: natal_datetime (required), natal_latitude (required), natal_longitude (required), relocation_latitude (required), +5 more.

ephemeris_retrograde_statusRetrograde StatusA
Read-onlyIdempotent
Inspect

Use this when the user asks 'is Mercury retrograde right now', 'was Mars retrograde when I was born' or 'which planets are retrograde at the moment'. Returns is_retrograde, speed and station proximity for one planet (Mercury is planet_id=2) or all ten.

CREDIT COST: 1 credit per planet (10 for all).

Inputs: datetime (required), timezone, planet_id.

ephemeris_solar_returnSolar ReturnA
Read-onlyIdempotent
Inspect

Use this when the user asks 'when exactly is my solar return', 'my birthday chart for this year' or 'my solar return for 2027 as JSON'. Returns the exact moment the Sun returns to its natal longitude near the birthday and the Solar Return chart for that year; target_datetime picks the year (defaults to the current one).

CREDIT COST: 5 credits per call.

Inputs: birth_datetime (required), timezone, visual_config, birth_latitude, +5 more.

ephemeris_synastrySynastry ChartA
Read-onlyIdempotent
Inspect

Use this when the relationship comparison is wanted as data — 'list our inter-aspects with orbs', 'what aspects does their Mars make to my Venus', 'our synastry as JSON'. Returns the cross-aspects between the two charts plus both natal charts; needs each person's birth datetime, zone and coordinates.

CREDIT COST: 3 credits per call.

Inputs: person_a_datetime (required), person_a_latitude (required), person_b_datetime (required), person_b_latitude (required), +8 more.

ephemeris_time_lordsTime LordsA
Read-onlyIdempotent
Inspect

Use this when the user asks for 'time-lord periods as data', 'releasing dates between two dates' or 'profection lords to compare with transits'. Returns time-lord periods over a date window as data: releasing levels 1–2 with peak and loosing flags, the profection year with house and lord, optional firdaria, and change dates.

CREDIT COST: 5 credits (natal + one Lot + profections); +2 per extra Lot or firdaria.

Inputs: birth_datetime (required), birth_latitude (required), birth_longitude (required), lot, +4 more.

ephemeris_transitsTransit SearchA
Read-onlyIdempotent
Inspect

Use this when the user asks 'when is my Saturn return', 'when does Pluto square my Sun', 'what transits do I have this month or next year', 'my biggest transits this year' — any WHEN-does-a-transit-hit question, as data. Returns the exact moments transiting planets form the requested aspect to natal points over a date range; sort=significance adds ranked, the hits scored biggest first.

ASPECT ANGLES (aspect_angle): 0 = conjunction/return (default), 180 = opposition, 90 = square, 120 = trine. Saturn return → transiting_planets=['saturn'], natal_points=['saturn']. Default transiting_planets and natal_points: sun through saturn; naming fewer is faster. MAX SPAN: Explorer/PayG 1y, Pro 5y, Startup 10y, Scale 40y (longer = 400). CREDIT COST: 1 + span price: ≤1y 5, ≤3y 10, ≤5y 15, ≤10y 25, ≤20y 40, ≤40y 70. truncated:true = partial, with the resume point in truncation.resume_from.

Inputs: end_date (required), start_date (required), natal_datetime (required), natal_latitude (required), +6 more.

explore_bazi_chartInteractive BaZi Four Pillars ExplorerA
Read-onlyIdempotent
Inspect

Use this when the user asks 'what's my BaZi', 'my Four Pillars', 'what's my Day Master', 'what's my Chinese zodiac animal and element' or 'my Chinese astrology chart'. Returns an interactive Four Pillars (四柱命盘) explorer (inline in Claude and ChatGPT; text summary elsewhere): the Year, Month, Day and Hour pillars — each with Heavenly Stem (天干), Earthly Branch (地支), Ten God label and element color — plus the Day Master identity and a Wu Xing (五行) element balance bar; click any pillar for what it reveals about that life domain.

CREDIT COST: 3 credits per call (1 base + 2 visual render).

Inputs: day, hour, year, month, +8 more.

explore_bi_wheelInteractive Bi-Wheel ExplorerA
Read-onlyIdempotent
Inspect

Use this when the user asks 'are we compatible', 'synastry with my partner', 'what's my horoscope for today', 'what's hitting my chart right now' or 'what's my solar return chart this year' — any two-ring comparison they should SEE — or 'our composite chart' / 'our Davison chart' for a couple's single relationship wheel. Returns an interactive bi-wheel (inline in Claude and ChatGPT; text summary elsewhere): inner wheel Person 1's natal chart, outer ring by mode — synastry (Person 2's natal; needs their birthplace), transit (a date; today for a daily horoscope), progressed, solar_arc (target date), solar_return (target year), lunar_return (target month) — with cross-aspects drawn and every planet, aspect line and cusp clickable. composite and davison instead return ONE wheel derived from both births (Person 2's birth datetime and birthplace required; composite is the midpoint method with no angles or houses, davison has real ones). Birthplaces may be place names (location, person2_location).

CREDIT COST: 2 credits per call for most modes (1 per wheel; +1 to resolve a place name); solar_return/lunar_return modes cost 6; composite/davison cost 3. house_system (placidus default; whole_sign) sets both rings' houses.

Inputs: person1_datetime (required), person2_datetime (required), mode, location, +10 more.

explore_human_designInteractive Human Design Bodygraph ExplorerA
Read-onlyIdempotent
Inspect

Use this when the user asks 'what's my Human Design', 'am I a Generator / Projector / Manifestor / Reflector', 'show my bodygraph' or 'what's my strategy and authority'. Returns an interactive bodygraph (inline in Claude and ChatGPT; text summary elsewhere): centers, gates, channels, Type, Profile, Authority and Incarnation Cross, each clickable. Birthplace may be a place name (location).

CREDIT COST: 4 credits per call (2 chart + 2 render; +1 to resolve a place name). Human Design was originated by Ra Uru Hu; Open Ephemeris is an independent calculation service, not affiliated with Jovian Archive.

Inputs: datetime (required), latitude, location, timezone, +1 more.

explore_human_design_connectionHuman Design Connection (Synastry)A
Read-onlyIdempotent
Inspect

Use this when the user asks 'are we compatible in Human Design', 'what's our connection chart', 'what channels do we make together' or 'show our composite bodygraph' — two people's HD charts overlaid. Returns an interactive two-person overlay bodygraph (inline in Claude and ChatGPT; text summary elsewhere) with every connected channel classified by HD connection theory: electromagnetic (attraction), companionship (sameness), dominance (one defines), compromise (friction).

CREDIT COST: 5 credits per call (composite 3 + render 2). Human Design was originated by Ra Uru Hu; Open Ephemeris is an independent calculation service, not affiliated with Jovian Archive.

Inputs: person_a (required), person_b (required), theme, layout, +1 more.

explore_human_design_transitHuman Design Transit OverlayA
Read-only
Inspect

Use this when the user asks 'what are today's Human Design transits for me', 'what gates are being activated for me right now' or 'how is the current sky affecting my bodygraph'. Returns an interactive overlay bodygraph (inline in Claude and ChatGPT; text summary elsewhere) with the channels the transit completes and centers it defines, now or at a chosen datetime. Birthplace may be a place name (location).

CREDIT COST: 5 credits per call (chart 3 + render 2; +1 per place name). Human Design was originated by Ra Uru Hu; Open Ephemeris is an independent calculation service, not affiliated with Jovian Archive.

Inputs: datetime (required), theme, layout, latitude, +5 more.

explore_moon_phaseInteractive Moon Phase ExplorerA
Read-onlyIdempotent
Inspect

Use this when the user asks 'what's the moon phase tonight', 'is tonight a full moon', 'show me the moon right now', 'what sign is the Moon in', 'is the Moon void of course' — or has no birth data and wants somewhere to start; it needs no arguments. Returns an interactive Moon dial (inline in Claude and ChatGPT; text summary elsewhere): illumination, phase, Moon sign and degree, void-of-course timing, lunar age, days to the next New and Full Moon, and the tightest applying aspects.

CREDIT COST: 3 credits per call (phase + void-of-course + aspects, 1 each).

Inputs: datetime, latitude, timezone, longitude.

explore_natal_chartInteractive Chart Wheel ExplorerA
Read-onlyIdempotent
Inspect

Use this when the user asks 'make my natal chart', 'show me my birth chart', 'what's my rising sign', 'my big 3', 'what's my sun, moon and rising', 'what sign is my Moon / Venus / Mars in', 'what does my chart say about my career / love', 'read my chart', or shares birth details and wants to explore them — any natal / birth-chart / astrology-chart request. Returns an interactive chart wheel rendered inline (Claude and ChatGPT; text summary elsewhere) where any planet, house or aspect line can be clicked for interpretation, with switchable house systems. The birthplace can be given as location (a place name — resolved server-side) or as coordinates, with the birth date, local time and zone.

CREDIT COST: 1 credit per call (+1 to resolve a place name).

Inputs: datetime (required), bodies, ayanamsa, latitude, +5 more.

explore_time_lordsInteractive Time Lords ExplorerA
Read-onlyIdempotent
Inspect

Use this when the user asks for 'zodiacal releasing', 'my profection year', 'who is my time lord this year', 'my firdaria', 'loosing of the bond' or 'when are my peak periods'. Returns an interactive timeline (inline in Claude and ChatGPT; text elsewhere): releasing from Spirit and Fortune with peaks and loosing of the bond, the profection wheel, firdaria and the next changes.

CREDIT COST: 9 credits (+1 to resolve a place name; +1 for a local birth time before 1970).

Inputs: datetime (required), latitude, location, timezone, +1 more.

explore_transit_timelineInteractive Transit TimelineA
Read-onlyIdempotent
Inspect

Use this when the user asks 'what's happening in my chart this month', 'what transits are coming up for me', 'what does my year ahead look like', 'when will Saturn hit my chart' or 'what's happening astrologically for me in 2027' — a forecast they should SEE. Returns an interactive, date-ordered timeline (inline in Claude and ChatGPT; text summary elsewhere) of exact transit hits grouped by month — transiting planet, natal point, aspect and retrograde markers — each clickable for a focused interpretation. Every hit carries its in-orb window (when the transit starts and ends, and which pass it is when a retrograde repeats it), and transits already in orb at the start are listed with applying/separating.

ASPECT ANGLES: 0 = conjunction/return (default), 180 = opposition, 90 = square, 120 = trine, 60 = sextile. EFFICIENCY: searches run faster when transiting_planets and natal_points are given. MAX SPAN: Explorer/PayG 1y, Pro 5y, Startup 10y, Scale 40y (longer = 400). CREDIT COST: 1 + span price: ≤1y 5 (6 total), ≤3y 10, ≤5y 15, ≤10y 25, ≤20y 40, ≤40y 70.

Inputs: end_date (required), start_date (required), natal_datetime (required), natal_latitude (required), +6 more.

explore_vedic_chartInteractive Vedic Chart ExplorerA
Read-onlyIdempotent
Inspect

Use this when the user asks 'show my Vedic chart', 'my kundli', 'my Indian astrology chart', 'what's my nakshatra', 'my sidereal birth chart' or 'what's my lagna'. Returns an interactive South Indian fixed-sign Rashi grid (inline in Claude and ChatGPT; text summary elsewhere) with sidereal (Lahiri by default) placements, nakshatra with pada, navamsa and the Lagna (Ascendant) rashi; click any rashi cell for its themes and the planets placed there. Birthplace may be a place name (location).

CREDIT COST: 3 credits per call (chart + render; +1 to resolve a place name).

Inputs: datetime (required), ayanamsa, latitude, location, +2 more.

find_calculationFind a CalculationA
Read-onlyIdempotent
Inspect

Use this when no typed tool fits, before dev_read_api or dev_write_api: KP or Varshaphal, the Chinese lunar calendar, bounds distributions, eclipses on a natal chart, Almuten or lunar mansions, sky recurrence, Venus star points, batch charts. Searches the Open Ephemeris API catalog by plain words and returns the best matches: path, which tool runs it, required inputs, an example request and the credit cost. Local, free, no API call.

Inputs: query (required), limit.

human_design_chartHuman Design ChartA
Read-onlyIdempotent
Inspect

Use this when the Human Design chart is wanted as data — 'give me my HD activations', 'what are my variables', 'my Human Design chart as JSON'. Returns Type, Strategy, Authority, Profile, Centers, Gates, Channels, Incarnation Cross, and Personality and Design planetary positions.

CREDIT COST: 2 credits per call.

Takes coordinates, not a place name.

Inputs: datetime (required), format, latitude, timezone, +4 more.

human_design_transit_timelineHuman Design Transit TimelineA
Read-onlyIdempotent
Inspect

Use this when the user asks 'when does transiting Saturn enter my gate 34' or 'when do I get channel 20-34 from transits'. Returns each gate entry and exit over a range; with birth data or natal_gates, when a transit completes one of the person's channels.

CREDIT COST: up to 1 year 5, 3 years 10, 5 years 15. Explorer plans: 1 year at most.

Inputs: end_date (required), start_date (required), bodies, latitude, +5 more.

timezone_resolveTimezone ResolveA
Read-onlyIdempotent
Inspect

Use this when the user asks 'what timezone is this location in' or 'what was the UTC offset there on that date', or coordinates are known and the IANA zone is needed for a local birth time. Returns the IANA zone and, with date, the historical UTC offset. CREDIT COST: 1 credit per call.

Inputs: latitude (required), longitude (required), date.

vedic_chartVedic Natal ChartA
Read-onlyIdempotent
Inspect

Use this when the Vedic / Jyotish chart is wanted as data — 'my sidereal placements as JSON', 'what's my current dasha', 'am I manglik', 'when is my sade sati', 'today's panchang', 'choghadiya today'. Takes coordinates. Returns sidereal rashis, nakshatra and pada, navamsa, Whole Sign bhavas; optional dasha, vargas, Manglik, Sade Sati, or the day's panchang with choghadiya and hora.

CREDIT COST: 1 credit per call.

Inputs: datetime (required), latitude (required), longitude (required), vargas, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 44 tools

    Disambiguation3/5

    The tool set is organized as a deliberate data-vs-visual split (ephemeris_natal_chart vs explore_natal_chart, ephemeris_transits vs explore_transit_timeline, vedic_chart vs explore_vedic_chart, human_design_chart vs explore_human_design), and descriptions state the distinction fairly explicitly. Still, there are ~10 near-duplicate pairs plus a crowded moon/electional cluster (ephemeris_moon_phase, explore_moon_phase, ephemeris_next_lunar_phase, electional_moment_analysis, ephemeris_electional, electional_station_tracker) that invite misselection. Boundaries are workable but require careful reading of descriptions.

    Naming Consistency3/5

    Names are readable but follow several competing schemes: domain prefixes (ephemeris_, explore_, acg_, bazi_, vedic_, human_design_, electional_, auth_, dev_) mixed with unprefixed tools (find_calculation, location_search, timezone_resolve, account_usage). The same conceptual operation appears under two prefixes (ephemeris_ vs explore_) rather than one verb_noun pattern. There is a discernible domain-prefix logic, so it is not chaotic, but it is not a single convention.

    Tool Count2/5

    44 tools is well beyond a comfortable surface for this domain, and a large fraction are parallel data/render variants of the same calculations. The breadth of astrology systems covered explains some of it, but an agent must choose among dozens of similar-sounding entries. This is an over-scoped surface rather than a well-curated set.

    Completeness5/5

    Coverage spans Western natal/transit/progression/return/relocation/house systems, synastry and bi-wheel, astrocartography, Vedic, BaZi, Human Design, electional, time lords, location/timezone resolution, auth/billing, and an escape hatch (find_calculation plus dev_read/write_api) for anything untyped. No meaningful dead ends for the stated purpose.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An AI-powered metaphysical Bazi calculator that provides accurate Chinese astrological chart calculations for personality analysis and destiny forecasting, addressing inaccuracies in existing AI fortune-telling tools.
      5
      262 npm
      435
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables generation of detailed Chinese Ziwei Doushu (Purple Star) astrological charts with geographic location support and true solar time conversion. Provides tools for geocoding locations, converting Beijing time to apparent solar time, and creating comprehensive astrology readings based on birth information.
      14
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Bazi MCP is an AI based Bazi calculator that provides accurate Bazi chart data for personality analysis and destiny prediction.
      3
      2
      Apache 2.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      World's first Vedic Astrology MCP Server — connect Claude, ChatGPT, Cursor, or any AI to real Vedic astrology. Provides horoscope predictions, compatibility matching, numerology, planetary positions, yogas and house analysis via MCP.
      11
      -