Connect Cursor

Remote HTTP MCP — Settings → Tools & MCP in Cursor.

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 recent version of Cursor (Settings → Tools & MCP).

Do you need an API key?

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/mcp

Setup steps

1
Obtain an AstroCodex Account API key at astrocodex.ai/api-keys.
2
In Cursor, open Settings → Tools & MCP (older builds: "Tools & Integrations") and click "Add new MCP server".
3
Enter Name: "AstroCodex", Type/Transport: "HTTP", URL: https://api.astrocodex.ai/api/v1/mcp
4
Add a header named X-API-Key with your key as the value (acx_…), click Install, then restart Cursor.
5
Open the Cursor AI chat panel and ask: "What charts do I have in AstroCodex?"

Config snippet

Config

{
  "mcpServers": {
    "astrocodex": {
      "url": "https://api.astrocodex.ai/api/v1/mcp",
      "headers": {
        "X-API-Key": "acx_YOUR_KEY_HERE"
      }
    }
  }
}

Instead of the UI you can drop the snippet into ~/.cursor/mcp.json (global, every project) or .cursor/mcp.json (project-scoped), then restart Cursor. Remote HTTP MCP servers are supported in current Cursor releases.

What you get — and what it costs

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.

Get API keys View plans