documentation

For you

Ask about your own chart, in the assistant you already use.

ClaudeLumin connected

Born 14 Aug 1992, 4.32 am, Colombo. Which period am I in now?

Lumin/get_dasha_periods

You are in the Jupiter period until April 2028. Its Rahu sub-period began in November 2025 and runs to the same date.

The ruleVimshottari, counted from the Moon's star, Dhanistha, ruled by Mars.

Reply to Claude

Lumintool call

get_dasha_periods

periodJupiter / Rahu

runs toApr 2028

Moon's starDhanistha

star lordMars

returned with the rule it used

01Sign in with your email. A six digit code, no password.
02Connect Lumin to Claude. The app walks you through it.
03Ask. Each answer names the rule behind it.

300 calls free every month. No card.

Use Lumin

For developers

Build it into your agent, or build a new one.

coding agent

›Build a WhatsApp bot for my travel desk that tells clients which morning to fly out. Use Lumin.

Write bot.ts

import { Client } from "@modelcontextprotocol/sdk/client/index.js";import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"; const lumin = new Client({ name: "travel-desk", version: "1.0.0" });await lumin.connect(new StreamableHTTPClientTransport( new URL("https://mcp.lumin.guru/mcp"), { requestInit: { headers: { Authorization: `Bearer ${process.env.LUMIN_API_KEY}` } } },)); whatsapp.on("message", async (msg) => { const res = await lumin.callTool({ name: "find_travel_departure_time", arguments: { ...profile(msg.from), scan_days: 7, preferred_time_of_day: { start: "06:00", end: "12:00" } }, }); await msg.reply(toReply(res));});

bot.ts written, wired to mcp.lumin.guru

TDTravel deskBusiness account

TODAY

Hi, I fly out next week. Which morning should I leave?09:41

Leave on Sun 8 Nov, between 06:00 and 09:29.09:42

The ruleElected on houses 3, 9 and 11 for a journey, from Astrology for Beginners, p.786.

Message

Lumintool call

find_travel_departure_time

startLocal2026-11-08T06:00

endLocal2026-11-08T09:29

electedHouses3, 9, 11

provenanceBOOK_SOURCED

returned with the rule it used

https://mcp.lumin.guru/mcp

One MCP endpoint and an API key. Tell your coding agent what to build, and it wires Lumin in.

Templates for Telegram, Discord, WhatsApp and Slack are coming. See them below ›

Start building

Agent templates

Coming soon. Clone one, add two keys, run it.

TTiming botbottyping…

Today

Born 14 Aug 1992, 4.32 am, Colombo. Which period am I in?09:41

You're in Jupiter, sub-period Rahu, until 19 Apr 2028.09:41

Show the rule

Vimshottari, counted from the Moon's star.Your Moon is in Dhanistha, ruled by Mars, so the sequence began with Mars.09:41

Message

Lumintool call

get_dasha_periods

moonNakshatraDhanistha

moonNakshatraLordMars

mahadashaJupiter

antardashaRahu

endDate2028-04-18

✓ returned with the rule and its source

Charts and timing in a chat.

Tells someone which dasha and sub-period they are in, and until when.
The bot writes the reply. Every period and date in it comes from get_dasha_periods.
A Show the rule button sends the rule, Vimshottari counted from the Moon's star.

SK+

Stargazers

# general

# panchang

# charts

# off-topic

# panchang

maya Today at 09:38

what's the nakshatra today?

Aasha used /panchang

Almanac APP Today at 09:41

Almanac is thinking…

Panchang, Colombo, Fri 9 Oct 2026

TithiKrishna ChaturdashiClassical

NakshatraU.Phalguni, pada 2KP core

YogaBrahmaClassical

Rahu Kaal10:27 to 11:57KP, conditional

Sunrise 05:57, sunset 17:58

Message #panchang/panchang city Colombo date 2026-10-09

Lumintool call

get_panchang

weekdayFriday

tithiKrishna Chaturdashi

nakshatraU.Phalguni

kpStanding.tithiCLASSICAL_REFERENCE

kpStanding.nakshatraKP_CORE

✓ returned with the rule and its source

A slash command for a server.

A /panchang command posts a city's panchang for a date, in one embed.
Tithi, nakshatra, yoga and Rahu Kaal all come from get_panchang.
Each row names its tradition, KP core or classical, so nobody mixes them up.

TDTravel deskBusiness accounttyping…

TODAY

Hi, I fly out next week. Which morning should I leave? Born 14 Aug 1992, 4.32 am, Colombo.09:41

Leave on Sun 8 Nov, between 06:00 and 09:29. That's the window KP's rules elect from your chart.09:42

Why that window?

Houses 3, 9 and 11 for a journey, Astrology for Beginners, p.786. It's fixed at the Moon sub, so it's hours wide, not minutes.09:42

Message

Lumintool call

find_travel_departure_time

startLocal2026-11-08T06:00

endLocal2026-11-08T09:29

resolvingLayermoon-sub

electedHouses3, 9, 11

✓ returned with the rule and its source

For businesses that sell by chat.

A business answers a client's timing question in the chat they already use.
Here a travel desk asks find_travel_departure_time for a week of mornings.
A Why that window? button replies with the houses and the book page they come from.

Studio

# general

# launch

# design

Apps

Timing

# launch

Priya 10:02 AM

@Timing a slot for the partner call next week? Office hours, my chart.

Timing APP 10:02 AM

Fri 16 Oct, 12:39 to 14:00.Add to calendar

Nothing else this week cleared the same layers. Houses 3, 6, 9, 10 and 11, Jyotish Astro Secrets, p.912. Fixed at the Moon sub.

Message #launch

Timing is typing…

Lumintool call

find_meeting_time

startLocal2026-10-16T12:39

endLocal2026-10-16T14:00

windowsFound1

electedHouses3, 6, 9, 10, 11

✓ returned with the rule and its source

Meeting and launch windows for a team.

Mention the app in a channel to get a window inside office hours.
It asks find_meeting_time and posts the window with the houses and the source.
When only one window clears, it says so. It gives no score.

Assistant

I sign the funding agreement next week. When should I sign?

sub-agent Timing find_contract_signing_time✓

Sign on Sat 17 Oct, between 10:14 and 10:17.Add to calendar

The ruleHouses 2, 6 and 11, never 5, 8 or 12. KP Reader 5, p.229.Fixed at the Ascendant sub, which fixes the minute.

Lumintool call

find_contract_signing_time

startLocal2026-10-17T10:14

endLocal2026-10-17T10:17

resolvingLayerascendant-sub

electedHouses2, 6, 11

✓ returned with the rule and its source

A timing sub-agent for big decisions.

Your assistant hands a timing question to a sub-agent and gets one answer back.
The sub-agent calls the named tool for the event, here find_contract_signing_time.
The answer carries the houses it needs and the houses it must avoid.

Templates are coming. The chats are illustrative. Every date and rule in them is recorded from the engine for one test chart, born 14 Aug 1992, 4.32 am, Colombo.

Reading your own chart instead? Connect Lumin to Claude ›