Connect Grok
Bring-your-own-MCP connector at grok.com/connectors.
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.
Grok on the web (grok.com/connectors) — custom MCP connectors ("Bring your own MCP") are available to Grok users.
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
Open grok.com/connectors (Grok on the web). Custom servers are part of Grok's "Bring your own MCP".
- 2
Click "New Connector" and choose "Custom".
- 3
Enter the AstroCodex MCP server URL: https://api.astrocodex.ai/api/v1/mcp
- 4
Complete the authentication step when prompted — sign in to AstroCodex and approve access. (The server is already public, so no tunnelling is needed.)
- 5
Ask Grok: "What are my saved AstroCodex birth charts?" and it will call the AstroCodex tools.
xAI shipped custom MCP connectors ("Bring your own MCP") across Grok on web, iOS and Android in 2026; the only requirement is that the server is reachable over the public internet (AstroCodex is). Developers can also attach the same endpoint as a remote MCP tool through xAI's API — the native SDK or the OpenAI-compatible Responses API (type "mcp").
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.