Tutorial / 5 minutes
Your first reading
By the end of this page you will have Lumin connected to Claude, a saved birth profile, and a worked reading on a real life question. No downloads, no code, just an email address and a six digit code.
Step 1 - Connect Lumin to Claude
Open Claude, then add Lumin as a custom connector. Paste this URL:
https://mcp.lumin.guru/mcpClaude will register the 158 tools Lumin exposes (pure KP, Vedic Parashari, Jaimini, and Tajik adjuncts), 8 of which are composite workflows that bundle 5-15 sub-calls into single atomic recipes (marriage, career, kundli match, year outlook, today, triple-dasha consensus, Karakamsa spiritual lens, pre-verdict audit). You will see them listed under your tools panel once the connection is established.
Connecting asks you to sign in to Lumin. Enter your email address, then the six digit code we send you. There is no password. The free plan includes 300 tool calls a month, plenty to finish this tutorial and run several complete readings.
For best results pick Claude Opus 4.7 with adaptive thinking turned on. For lighter follow-up questions, Claude Sonnet with adaptive thinking is a faster default. See recommended model settings for why.
Step 2 - Set your birth profile
Tell Claude who the reading is for. Lumin will hold 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.
You will see Lumin run between fifteen and forty tool calls in sequence. That is the seven-phase KP reading protocol working through chart, promise, dasha, transits, ruling planets, advanced techniques, and synthesis.
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. You can verify any claim against the supporting data inline, which is the promise behind "personalization you can trace."
Stuck?
If Claude is not picking up the tools, double-check the URL and that your Claude tier supports custom connectors. The Connect page on lumin.guru has a click-by-click walk-through with screenshots.
Where to next
- 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 when you might want more than the monthly allowance.