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 and sign in with your email address and the six digit code we send you. The same URL takes an API key if you would rather pass one.
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 sign in when prompted. 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
Custom clients
- Lumin uses Streamable HTTP transport with
enableJsonResponse: true. - Standard MCP request shapes:
tools/list,tools/call. - OAuth 2.1 discovery exposed at
/.well-known/oauth-authorization-server. - API key auth:
Authorization: Bearer mcp_*header. - Every request carries credentials. There is no credential-free access.