Skip to content
Lumin
HomeMCPBlogContact
Request a ReadingUse with Claude
Back to Home

For everyone

Connect Lumin with any AI client

52 KP astrology computation tools, available as an MCP server. Works with Claude, Cursor, Windsurf, and any MCP-compatible client.

52

Computation tools

66

Life events analyzed

14

Advanced techniques

7

Reading phases

Quick start

1

Open claude.ai

Go to Settings, then Connectors, then Add custom connector.
2

Enter the server URL

https://mcp.lumin.guru/mcp

No OAuth setup needed. Leave the advanced fields empty.

3

Start using

Ask Claude anything about astrology. It will call the KP tools automatically.

Free tier: 50 tool calls per day, no account required. Get an API key for 100/day.

Setup by client

Config file

Claude Desktop

Add to your Claude Desktop developer settings:

{
  "mcpServers": {
    "lumin-kp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.lumin.guru/mcp"
      ]
    }
  }
}
Terminal

Claude Code

Run in your terminal:

claude mcp add --transport http lumin-kp https://mcp.lumin.guru/mcp
MCP config

Cursor / Windsurf

Add to your MCP server config:

{
  "mcpServers": {
    "lumin-kp": {
      "url": "https://mcp.lumin.guru/mcp"
    }
  }
}
Higher limits

With authentication

Use the authenticated endpoint for 100 calls/day with Google sign-in:

{
  "mcpServers": {
    "lumin-kp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.lumin.guru/mcp/auth"
      ]
    }
  }
}

52 tools included

Natal Charts

Full KP chart with planets, houses, dasha, significators, and ruling planets

Event Timing

Predict when events will occur based on dasha periods and ruling planets

Transit Analysis

Compare natal chart with current transits and activation scores

Compatibility

KP synastry between two charts with 7-factor scoring

Doshas

Detect Manglik, Kalsarpa, Sadhesati, Pitra, and Kemadruma with remedies

Annual Forecast

12-month predictions with dasha themes and monthly tone

Plans

No account

Free

50 tool calls per day

Just add the server URL to your client. No sign-up, no API key, no configuration.

With account

Free with API key

100 tool calls per day

Sign in at app.lumin.guru, go to Developer, and generate a free API key for higher daily limits.

Get API key

Server details

Protocol: MCP (Streamable HTTP)

Server URL: https://mcp.lumin.guru/mcp

Auth URL: https://mcp.lumin.guru/mcp/auth

Tools: 52 KP astrology computations

Auth: Authless, API key, or OAuth 2.1

Status: Health check

Privacy: Privacy policy

Support: contact@lumin.guru