Connect Claude
Native MCP support — connect over OAuth in seconds.
Connecting AstroCodex to your AI assistant links it to the Account MCP — so it can access your saved charts, run techniques, fetch transits, and compute synastry, all within your normal AI conversation.
What you need
An AstroCodex account on a plan that includes Account API/MCP. Many assistants connect by signing in via OAuth — no key to create; an Account API key (from /api-keys) is only needed for clients you configure by hand.
Claude Desktop (any plan) or Claude Code (CLI).
Often not. When you paste the MCP URL, many assistants (Claude, ChatGPT) show a "Sign in / Connect" button — approve access to your AstroCodex account and you are done, with no key to manage. The steps below describe the manual API-key method, for clients you configure with an X-API-Key header instead.
Account MCP URL
https://api.astrocodex.ai/api/v1/mcpSetup steps
- 1
In Claude Desktop (or claude.ai) open Settings → Connectors → "Add custom connector".
- 2
Paste the AstroCodex MCP URL https://api.astrocodex.ai/api/v1/mcp and give it a name, e.g. "AstroCodex".
- 3
Click Connect — Claude opens an AstroCodex sign-in page. Log in and approve access to your charts (OAuth). No API key to create or paste.
- 4
Back in Claude, make sure the AstroCodex connector is enabled for your conversation.
- 5
In a new conversation, type "list my charts" — Claude will invoke the AstroCodex tools automatically.
Claude Desktop and claude.ai connect to remote MCP servers over OAuth: you sign in to AstroCodex and approve access — no API key, no config file. (Older Claude Desktop builds without the Connectors UI can still use a local stdio MCP bridge that forwards your key in an X-API-Key header, but the OAuth connector is the recommended path.)
Once connected, your AI assistant can create and edit charts in your AstroCodex account, pull their calculated data (planets, houses, yogas, dashas, transits, synastry…), and interpret it for you — all inside your normal chat. The analysis runs on the model you already pay for (Claude, GPT-4o, Gemini, Grok…), so it does NOT spend AstroCodex tokens. Only your plan's request limit and monthly quota apply: fetching chart data counts as requests, never tokens.