Reference

Supported clients

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

Not using a client at all?

The Lumin app at app.lumin.guru needs no client and no setup: you sign in, add your own Anthropic API key on the profile page, and read in the browser. Everything below is for reading through an MCP client instead.

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)

Install the plugin. It adds the server, the reading methodology and a command per topic in one step, and it is the only client where the tool-call floor is enforced rather than requested.

bash

/plugin marketplace add https://www.lumin.guru/plugin/marketplace.json
/plugin install lumin@lumin

You are asked for your birth details once during install, so readings never make you retype them. Full walkthrough in the plugin guide.

To add the server on its own instead, run claude mcp add --transport http lumin-kp https://mcp.lumin.guru/mcp and sign in when prompted. That path gives you the tools without the commands or the floor.

Recommended model settings

A complete Lumin reading spans 25 to 40 tool calls, with a hard floor of 20 on any life-area question, 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, with extended thinking turned on. 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 speaks Streamable HTTP. Every response, including a tool result, arrives as an SSE stream, so a request needs Accept: application/json, text/event-stream (both values) or the server answers 406.
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.

PreviousPlans and limits NextBilling and top-ups