Open Ephemeris
Open Ephemeris MCP server computes real astrology and related charts from NASA JPL DE440, returning interactive visuals or raw data.
Cast and explore natal charts, bi-wheels, synastry, transits, returns, progressions, relocation, composites, and time-lord periods.
Open interactive chart wheels, bodygraphs, grids, and timelines for natal, Human Design, Vedic, BaZi, moon phase, time lords, and electional timing.
Compute ephemeris data: planetary positions, house cusps, angles, aspects, ingresses, retrograde stations, moon phases/VOC, eclipses, fixed stars, dignities, midpoints, and Hermetic Lots.
Generate Human Design charts, transit overlays, connection charts, extended placements, penta, returns, and gate transit timelines.
Generate Vedic/Jyotish charts with dashas, vargas, panchang, Manglik, Sade Sati, and BaZi Four Pillars/annual pillars.
Find electional timing windows, score moments, track stations, search aspects, and compute astrocartography lines and location hits.
Resolve locations/timezones, manage account/auth/usage, and access allowlisted API endpoints via find_calculation/dev_read_api/dev_write_api.
Return compact LLM-formatted text, JSON, or inline interactive apps in Claude/ChatGPT, with per-call credit costs.
Provides example curl commands for interacting with the OpenEphemeris REST API, useful for debugging and rapid prototyping.
The MCP server is published as an npm package available for integration with AI agents.
The OpenAPI 3.0 specification can be imported into Postman for API testing and exploration.
Provides Python example scripts for natal charts, transit searches, Human Design, and deep data queries via the OpenEphemeris API.
The OpenAPI 3.0 specification can be imported into Swagger UI for API documentation and testing.
Provides TypeScript example code for web rendering and GeoJSON map visualizers, prepared for React setups.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
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-serverAny 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_HEREin 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 |
|
Cursor | One-click deeplink or manual |
|
Claude Desktop (macOS) | Manual |
|
Claude Desktop (Windows) | Manual |
|
Windsurf | Manual |
|
ChatGPT | One-click | |
Claude Web / remote clients | Hosted URL |
|
Client install walkthroughs
Cursor
Click the "Install in Cursor" button above, then replace
YOUR_API_KEY_HEREin Cursor MCP settings.If you prefer manual setup, paste the
mcpServers.openephemerisblock from "Manual install" into~/.cursor/mcp.json.
Claude Desktop (macOS/Windows)
Open the platform config file from the table above.
Add the same
mcpServers.openephemerisblock from "Manual install".Restart Claude Desktop.
Windsurf
Open
~/.codeium/windsurf/mcp_config.json(or the legacy~/.codeium/mcp_config.jsonpath).Add the
mcpServers.openephemerisblock 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/mcpas 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 Ephemerisin any chat. Charts render inline, exactly as they do in Claude. Prefer to wire it yourself? Settings → Plugins → Advanced → Developer mode → + Create app acceptshttps://mcp.openephemeris.com/mcpwith 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 athttps://openephemeris.com/login?signup=true&redirect=%2Fdashboard%3Ftab%3Daccount, then create/manage keys inhttps://openephemeris.com/dashboard?tab=account.Tier-gated endpoint (
403): tool call returns an upgrade-required message withhttps://openephemeris.com/payand 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 (any4xx/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 |
| Natal wheel — planets, houses, aspects, angles | Planets, houses, aspect lines; recalculate with new settings | 1 |
| Two charts on one wheel: transits, synastry, progressions | Either wheel's planets, houses, and the aspects between them | 2 (6 for solar/lunar return) |
| Human Design bodygraph, with a mandala view toggle | Centers, gates, channels, planets, variables | 4 |
| Today's planets laid over a natal bodygraph | Transit-activated channels | 5 |
| Two bodygraphs combined, every shared channel classified | Connection channels by type | 5 |
| South Indian Rashi grid — sidereal placements and Lagna | Each rashi, for its placements and nakshatras | 3 |
| Four Pillars (四柱命盘) — Year, Month, Day, Hour | Each pillar | 3 |
| Upcoming transit hits in date order | Individual hits | 6 for up to 1 year (priced by span) |
| Moon dial — illumination, phase, sign, void-of-course | Recalculate for another moment | 3 |
| 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 |
| 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 |
| Explorer |
Transit forecast |
| Explorer |
Transit chart snapshot |
| Explorer |
Sign ingresses / planet to degree |
| Explorer |
Moon phase / VOC |
| Explorer |
Eclipse next visible |
| Explorer |
Electional window |
| Pro |
Moment analysis |
| Explorer |
Station tracker |
| Explorer |
Aspect search |
| Pro |
Human Design chart |
| Explorer |
HD composite |
| Explorer |
HD transit overlay |
| Explorer |
HD transit timeline (gates over a date range) |
| Explorer |
HD extended placements (asteroids, angles, lots, stars) |
| Explorer (deep fields Pro) |
HD connection (synastry) |
| Explorer |
HD penta |
| Explorer |
HD return / opposition |
| Explorer |
Vedic chart |
| Explorer |
BaZi (Chinese) |
| Explorer |
Synastry |
| Explorer |
Composite chart |
| Explorer |
Relocation chart |
| Explorer |
Progressed chart |
| Explorer |
Solar return |
| Explorer |
Lunar return |
| Explorer |
Planetary return |
| Explorer |
Astrocartography lines |
| Pro |
ACG hits at location |
| Pro |
Venus Star Points |
| Explorer |
Chart wheel image |
| Explorer |
Bi-wheel image |
| Explorer |
Dignities / Midpoints / 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_calculationsearches the allowlisted operations by plain words and returns the path, inputs, an example and the credit cost (dev_list_allowedlists them all, outside core);dev_read_apiinvokes allowlisted GET (read) operations anddev_write_apiinvokes allowlisted POST/PUT/PATCH/DELETE (write/compute) operations, each bymethod + 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 |
|
| No | HTTP method (defaults to the tool's natural method) |
|
| Yes | Absolute API path, e.g. |
|
| No | Query parameters |
|
| No | JSON body for non-GET requests |
|
| No | Convenience mapping to |
|
| No | Convenience mapping to |
|
| No | Legacy compatibility field |
Environment Variables
Variable | Required | Description |
| Yes (unless service key/JWT used) | API key for Open Ephemeris |
| No | Legacy alias for |
| No | Defaults to |
| No |
|
| No |
|
| No | Set to |
| No | Bearer token auth |
| No | Override allowlist file path |
| 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=1Tool 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-serverOn the remote HTTP server, append ?profile=full to the connector URL (or send X-OE-Tool-Surface: full):
https://mcp.openephemeris.com/mcp?profile=fullToolsets 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-serverhttps://mcp.openephemeris.com/mcp?profile=hd,baziToolset | What it covers | Tools | Approx. tokens |
| Natal, transits, ingresses, synastry, progressions, returns, relocation, time lords, dignities, midpoints, lots, fixed stars, composites, birth-time sensitivity | 39 | 18,050 |
| Human Design charts, transits and transit timeline, extended placements, connection charts, penta, bodygraph | 19 | 8,500 |
| Four Pillars, Ten Gods, element balance, luck pillars, compatibility, Zi Wei Dou Shu | 16 | 8,100 |
| Timing windows, group timing, angle crossings, stations, moment analysis | 13 | 4,950 |
| Astrocartography lines and hits | 9 | 3,400 |
| Jyotish Rashi chart, dashas, vargas, Ashtakoota matching | 10 | 3,400 |
| Phases, void-of-course, eclipses | 11 | 3,300 |
| Star points, phases, elongations, stations | 13 | 3,200 |
| 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.
Legal
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=0Registered tools (
OPENEPHEMERIS_PROFILE=dev): 111Typed 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_chartGeneric tools:
dev_list_allowed,dev_read_api,dev_write_api,find_calculation
Allowlist Families
Family | Operations | Example |
| 14 |
|
| 3 |
|
| 3 |
|
| 12 |
|
| 5 |
|
| 6 |
|
| 7 |
|
| 43 |
|
| 2 |
|
| 11 |
|
| 2 |
|
| 1 |
|
| 14 |
|
| 1 |
|
| 5 |
|
| 1 |
|
| 6 |
|
| 3 |
|
| 5 |
|
| 3 |
|
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 toolsaccount_usageAccount UsageARead-onlyIdempotentInspect
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 HitsARead-onlyIdempotentInspect
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 LinesARead-onlyIdempotentInspect
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 AccountADestructiveIdempotentInspect
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 StatusARead-onlyIdempotentInspect
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 PillarARead-onlyIdempotentInspect
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 ReadARead-onlyIdempotentInspect
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)ARead-onlyIdempotentInspect
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 AnalysisARead-onlyIdempotentInspect
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 TrackerARead-onlyIdempotentInspect
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 & PointsARead-onlyIdempotentInspect
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 CheckARead-onlyIdempotentInspect
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 TimingARead-onlyIdempotentInspect
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 CuspsARead-onlyIdempotentInspect
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 IngressesARead-onlyIdempotentInspect
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 PhaseARead-onlyIdempotentInspect
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 ChartARead-onlyIdempotentInspect
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 FinderARead-onlyIdempotentInspect
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 PhaseARead-onlyIdempotentInspect
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 PositionARead-onlyIdempotentInspect
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 ChartARead-onlyIdempotentInspect
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 ChartARead-onlyIdempotentInspect
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 StatusARead-onlyIdempotentInspect
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 ReturnARead-onlyIdempotentInspect
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 ChartARead-onlyIdempotentInspect
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 LordsARead-onlyIdempotentInspect
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 SearchARead-onlyIdempotentInspect
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 ExplorerARead-onlyIdempotentInspect
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 ExplorerARead-onlyIdempotentInspect
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 ExplorerARead-onlyIdempotentInspect
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)ARead-onlyIdempotentInspect
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 OverlayARead-onlyInspect
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 ExplorerARead-onlyIdempotentInspect
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 ExplorerARead-onlyIdempotentInspect
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 ExplorerARead-onlyIdempotentInspect
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 TimelineARead-onlyIdempotentInspect
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 ExplorerARead-onlyIdempotentInspect
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 CalculationARead-onlyIdempotentInspect
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 ChartARead-onlyIdempotentInspect
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 TimelineARead-onlyIdempotentInspect
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.
location_searchLocation SearchARead-onlyIdempotentInspect
Use this when the user gives a birth city, hometown or any place name — 'born in Chicago', 'Mumbai, India', 'what timezone was Paris in 1985' — and a chart needs coordinates and a timezone. Returns display name, region (state/province), latitude, longitude and IANA timezone. With the birth date as date it also returns utcOffsetAtDate, the historically-correct UTC offset for that place on that date; post-1970 dates resolve locally at no extra cost, pre-1970 dates consult the historical overlay for the top match (+1 credit) and return its provenance. The result is flagged ambiguous when several places share the name (e.g. "portland"). A trailing "City, ST" qualifier in the query is honored. CREDIT COST: 1 credit per call.
Inputs: query (required), date, near, admin1, +2 more.
timezone_resolveTimezone ResolveARead-onlyIdempotentInspect
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 ChartARead-onlyIdempotentInspect
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
Scored across 44 tools
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.
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.
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.
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
Related MCP Connectors
Official Divine API MCP for Western Astrology: Natal, Synastry, Transit, Composite, Progressions.
Ephemeris-grade natal charts, current transits, zodiac sign profiles. No API key.
Swiss Ephemeris natal chart, 3D soul synastry & cosmic ephemeris oracle (<1.5ms, Zero-Auth).
Swiss Ephemeris astrology: natal charts, transits, synastry, solar returns and astrocartography.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn 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.5262 npm435ISC
- AlicenseNot gradedqualityDmaintenanceEnables 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.14MIT
- AlicenseBqualityDmaintenanceBazi MCP is an AI based Bazi calculator that provides accurate Bazi chart data for personality analysis and destiny prediction.32Apache 2.0
- FlicenseNot gradedqualityDmaintenanceWorld'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-