Reference

Supported clients

Lumin speaks the public Model Context Protocol over Streamable HTTP. Any compliant client works. These are the ones we test against.

Claude (web and desktop)

Add Lumin as a custom MCP connector. Paste https://mcp.lumin.guru/mcp for the open tier, or https://mcp.lumin.guru/mcp/auth with OAuth for the higher-limit tier.

This is the recommended client for everyday readings. The full seven-phase protocol runs cleanly inside a single Claude conversation, and visual blocks (charts, tables, dasha annotations) render inline.

Claude Code (CLI)

Run claude mcp add --transport http lumin-kp https://mcp.lumin.guru/mcp and you are connected. Useful for scripted readings, batch chart comparisons, or long horary sessions inside a terminal workflow.

Recommended model settings

A complete Lumin reading spans 25 to 40 tool calls and reasons across cuspal sublords, dashas, transits, ruling planets, and specialist techniques. The model you pick changes how cleanly that chain holds together at the synthesis step.

For precision (recommended). Claude Opus 4.7 with adaptive thinking turned on, or higher. Best for marriage timing, foreign settlement, medical timing, legal questions, rectification, and any reading where you want the strongest synthesis.
For general questions. Claude Sonnet with adaptive thinking. Faster and lighter. A good default for follow-up questions inside an existing reading, horary lookups, panchang checks, and quick chart summaries.

Note

Adaptive thinking gives the model more reasoning room on the synthesis step (Phase 7), which is where weaker setups compress the chain into platitudes. Turn it on whenever the answer needs to carry weight.

Custom clients

Lumin uses Streamable HTTP transport with enableJsonResponse: true.
Standard MCP request shapes: tools/list, tools/call.
OAuth 2.1 endpoints exposed at /.well-known/oauth-authorization-server on the auth endpoint.
API key auth: Authorization: Bearer mcp_* header.

PreviousTiers and limits NextBilling and upgrades