Tutorial / 5 minutes

Your first reading

By the end of this page Lumin will be connected to Claude, your birth details will be set, and you will have a worked reading on a real question. You need no downloads and no code, only an email address.

Would you rather paste one prompt and let Claude do the rest? Set up with a prompt has one for each client.

Step 1 - Connect Lumin to Claude

1. Open Claude, then open Settings and go to Connectors.
2. Click Add custom connector. Name it Lumin and paste this URL:

https://mcp.lumin.guru/mcp

3. Click Connect. Enter your email address, then the six digit code we send you. There is no password.

Claude now lists the 315 Lumin tools. They cover KP, Parashari, Jaimini and Tajik, and 8 of them are composite workflows that run a whole reading step in one call. Your account starts with 300 tool calls a month free, enough for this tutorial and several complete readings.

Pick the strongest model Claude offers and turn extended thinking on. A reading is a long chain of evidence, and the extra reasoning room shows at the synthesis step. See recommended model settings for why.

Step 2 - Set your birth profile

Tell Lumin who the reading is for. It holds this in context for the whole conversation, so you only set it once.

Set my birth profile:
- Born: 1992-08-14 at 04:32 (IST)
- Place: Colombo, Sri Lanka (6.927N, 79.861E)

If you do not know your exact birth time, ask for birth time rectification later. Lumin can narrow it from known life events.

Step 3 - Ask a real question

Lumin works best with a clear, specific question. Tap any of these to copy it.

• When is marriage timing strongest in the next two years?Copy
• Is a job change favorable in the current dasha?Copy
• What does my chart say about foreign settlement?Copy
• Is my health under stress right now, and when does it clear?Copy
• Is the fertility window open in the next 12 months?Copy
• Should I buy this property, and is the timing favorable?Copy

You will see Lumin run a long sequence of tool calls, usually 25 to 40 for a life-area question. That is the seven-phase KP reading protocol working through chart, promise, dasha, transits, ruling planets, advanced techniques, and synthesis. The floors are enforced, so a question about marriage, career, health, money, or the timing of an event never gets answered in one or two calls.

Step 4 - Read the answer

Every answer Lumin gives carries the math: the cuspal sublord, the active dasha lords, the ruling planets, the transit hierarchy. It also carries the rule each claim rests on and where that rule comes from, so you can check a reading the way a practitioner would check another practitioner, rather than taking it on faith.

Where to next

• Example readings has copyable prompts and worked examples for 13 life situations.
• Ask better questions covers the phrasing patterns that get the strongest answers.
• The seven-phase reading walks through what Lumin is doing in those tool calls.
• Plans and limits covers the connector meter and when you might want more than the monthly allowance.

Other ways to read

Working in Claude Code? Install the Lumin plugin instead. It adds the reading method and a command for each topic.

There is also a Lumin web app at app.lumin.guru. It runs on an Anthropic API key of your own and is billed by Anthropic, not by Lumin. The Lumin app covers how to set it up.