AstroCodex API
Two surfaces, one platform. Connect your application or AI assistant to 390+ astrological calculators, your saved charts, transit feeds, and synastry — via REST or MCP.
Two API surfaces
In short: the Engine API exposes calculators (astrological techniques); the Account API works with your saved charts; via MCP both appear to AI assistants as tools.
Account API
Your saved charts, techniques, transits, and synastry. Authenticate with an Account API key or OAuth (scope: account). The AI reasoning runs on your own assistant — it does not consume your AstroCodex token balance.
https://api.astrocodex.aihttps://api.astrocodex.ai/api/v1/mcpEngine API
390+ astrological calculators — Vedic, Western, Hellenistic, and more. Authenticate with an Engine key or OAuth (scope: rest_mcp). Rate limits and monthly quotas are set per B2B tier.
https://engine.astrocodex.aihttps://engine.astrocodex.ai/v1/mcpWhat's inside
Account REST API
REST endpoints for charts, techniques, transits and synastry — the same the apps use. Auth: X-API-Key.
Account MCP
MCP at /api/v1/mcp — connect your AI assistant to your saved charts. 11 tools, scope: account.
Engine REST API
POST /v1/calc/{name} — 390+ calculators over REST. Names returned in all 4 languages.
Engine MCP
MCP at /v1/mcp — same calculators via tools/list + tools/call, scope: rest_mcp.
Connect an AI assistant
Step-by-step guides for adding the AstroCodex Account MCP connector to your favourite AI — Claude, ChatGPT, Grok, Gemini, or Cursor.
Connect ChatGPT
Add AstroCodex as an MCP connector in ChatGPT Developer mode (OAuth).
Connect Claude
Native MCP support — connect over OAuth in seconds.
Connect Grok
Bring-your-own-MCP connector at grok.com/connectors.
Connect Gemini
MCP via the Gemini CLI (~/.gemini/settings.json).
Connect Cursor
Remote HTTP MCP — Settings → Tools & MCP in Cursor.