Connect ChatGPT
Add AstroCodex as an MCP connector in ChatGPT Developer mode (OAuth).
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.
A ChatGPT Plus, Pro, Business, Enterprise or Edu plan, used on the web — Developer mode (full MCP connectors) is required; Free and the mobile apps cannot add custom connectors.
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
Use ChatGPT on the web with a Plus, Pro, Business, Enterprise or Edu plan — full MCP connectors are not available on Free or in the mobile apps.
- 2
Open Settings → Apps & Connectors → Advanced settings and turn on "Developer mode" (full MCP client).
- 3
Back in Apps & Connectors, click "Create" / "New connector", name it "AstroCodex" and paste the MCP server URL: https://api.astrocodex.ai/api/v1/mcp
- 4
Set Authentication to "OAuth" and click Create/Connect — ChatGPT opens an AstroCodex sign-in page; log in and approve access to your charts. No API key to paste.
- 5
Start a new chat, enable the AstroCodex connector from the "+" / connectors menu, and ask "list my charts" — ChatGPT calls the AstroCodex tools.
ChatGPT's Developer mode is a full MCP client (read + write) for remote HTTPS servers only, and it authenticates over OAuth — so there is no API key or config file to manage, you just authorize AstroCodex like any other connector. Note: this is NOT the same as a Custom GPT "Action" (Actions take an OpenAPI schema and cannot consume an MCP endpoint). Free ChatGPT and the iOS/Android apps do not expose custom connectors.
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.