AstroCodex API
Two surfaces, one platform. Connect your application or AI assistant to 400+ astrological calculators, your saved charts, transit feeds, and synastry — via REST or MCP.
Two API surfaces
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.ai…/api/v1/mcpEngine API
400+ 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.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. 10 tools, scope: account.
Engine REST API
POST /v1/calc/{name} — 400+ 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
Custom connector for ChatGPT (Plus, Pro, or Team) via Actions.
Connect Claude
Native MCP in Claude Desktop or one command in Claude Code.
Connect Grok
Custom tool connector in Grok (xAI SuperGrok or API).
Connect Gemini
Google AI Studio Extensions or Gemini API tool definitions.
Connect Cursor
Remote HTTP MCP server — Settings → MCP in Cursor 0.44+.