Kundlit Vedic Astrology
Free Vedic astrology tools: daily panchang for any city, janam kundali birth charts, kundli milan matching, manglik dosha and sade sati - deterministic Swiss Ephemeris results, no API key.
Documentation
FOR AI ASSISTANTS · MODEL CONTEXT PROTOCOL
Kundlit MCP Server
Give Claude, ChatGPT, Cursor or any MCP-capable assistant real Vedic astrology computation: daily panchang and muhurta timings for any city, janam kundali birth charts, kundli milan matching, dosha checks, pancha pakshi timing, festival and eclipse calendars, and numerology — computed live with the Swiss Ephemeris, free, with no API key.
SERVER URL · STREAMABLE HTTP · NO AUTH
- Free, no keyNo account, no sign-up, no OAuth. Paste the URL and it works.
- Deterministic, not AI-made-upSwiss Ephemeris, Lahiri ayanamsa — the same engine behind our free tools.
- Read-only & safeEvery tool is pure computation: read-only, non-destructive, no side effects.
The 16 tools
Get the Hindu panchang (Vedic almanac) for a date and place: tithi, nakshatra, yoga, karana, weekday lord, lunar month, sunrise/sunset, auspicious windows (abhijit muhurta, good choghadiya) and inauspicious periods (rahu kaal, yamaganda, gulika kala). Computed with Swiss Ephemeris, Lahiri ayanamsa. Works for any city worldwide; date defaults to today at that place.
Try it on the site: kundlit.com/aaj-ka-panchang
Generate a Vedic birth chart (janam kundali) summary from a birth date, time and place: ascendant (lagna) with nakshatra and lord, sidereal positions of all nine grahas with house, nakshatra and dignity, the currently running Vimshottari dasha (mahadasha and antardasha), and notable classical yogas found in the chart.
Try it on the site: kundlit.com/janam-kundali
Marriage compatibility (kundli milan / gun milan) between two people using the classical Ashtakoot method: eight koots (varna, vashya, tara, yoni, graha maitri, gana, bhakoot, nadi) scored out of 36 points, with doshas, cancellations and an overall verdict.
Try it on the site: kundlit.com/kundli-milan
Check whether a person is Manglik (Mangal / Mars dosha) from their birth details: verdict with severity (none/mild/medium/high), which reference points trigger it (ascendant, Moon, Venus), classical cancellations that apply, and traditional remedies.
Try it on the site: kundlit.com/manglik-dosha
Find a person's Sade Sati status -- Saturn's roughly 7.5-year transit over the natal Moon sign: whether it is active, the current phase (rising/peak/setting) with dates, upcoming phases, the natal Moon rashi, Saturn's current position, and small-panoti (dhaiya) status. Optionally evaluate as of a specific date.
Try it on the site: kundlit.com/sade-sati
Check whether a birth chart has Kaal Sarp dosha -- all seven classical grahas hemmed between Rahu and Ketu: verdict, which of the 12 named types it is (Anant, Kulik, Vasuki...), whether the hemming is full or partial, the affected houses, and a plain explanation.
Try it on the site: kundlit.com/kaal-sarp-dosh
Tamil Pancha Pakshi Shastra personal timing: resolves the birth bird (Vulture, Owl, Crow, Cock or Peacock) from the birth details, then returns the day's yaama schedule with sub-periods rated 1-10 for starting important work. Optionally evaluate a specific date instead of today.
Try it on the site: kundlit.com/pancha-pakshi-calculator
Every auspicious and inauspicious time window for a date and place, in one call: all 16 choghadiya with quality, the 24 planetary horas, rahu kaal / yamaganda / gulika kala, abhijit + brahma + vijaya + godhuli + nishita muhurta, amrita kalam, varjyam, dur muhurtam, bhadra windows, panchak status and disha shool (travel direction to avoid). Pass janma_nakshatra / janma_rashi for a personal tarabala and chandrabala verdict for the day.
Try it on the site: kundlit.com/choghadiya
Dated Hindu calendar events for a whole year at a city: category 'festival' returns every festival and vrat (Holi, Diwali, Navratri, Shivratri...), or narrow to all 'ekadashi', 'purnima', 'amavasya' or 'sankranti' dates. Each event carries its exact local date and a one-line significance. Optional month filter (1-12). Years from two back to two ahead.
Try it on the site: kundlit.com/festival-calendar
All solar and lunar eclipses in a calendar year with local visibility for a city: type (total/partial/annular/penumbral), date, sparsha (first contact), madhya (maximum) and moksha (release) times, magnitude, and whether each eclipse is visible at that location -- sutak rules only apply where it is visible.
Try it on the site: kundlit.com/eclipses
Vedic numerology reading from a date of birth: mulank (root/psychic number from the day) and bhagyank (destiny/life-path number from the full date) with their ruling planets and meanings, plus traditional lucky attributions (numbers, colours, day, direction, gemstone). Optionally pass a name for the Chaldean name number.
Try it on the site: kundlit.com/numerology
Light-hearted name-compatibility score between two people using Pythagorean numerology: each name reduces to a number 1-9 and the pair maps to a 0-100 score with a short reading. Entertainment-grade -- for serious marriage matching use match_kundli (birth-chart based) instead.
Try it on the site: kundlit.com/love-calculator
Numerological reading of a mobile/phone number: digits are summed and reduced to a single number 1-9 whose ruling planet sets the number's overall vibe, plus a per-digit meaning list. Formatting (+, spaces, hyphens) is ignored.
Try it on the site: kundlit.com/mobile-number-numerology
The core identity of a Vedic birth chart in one call: the Moon's janma nakshatra (birth star) with pada and its 1-27 number, the moon sign (janma rashi) with its classical lord and house, the lagna (ascendant) with degree, nakshatra and lord, and the navamsa (D9) lagna. Lighter than get_janam_kundali when the user only asks for their nakshatra, moon sign or ascendant.
Try it on the site: kundlit.com/nakshatra-calculator
The Vimshottari dasha timetable for a birth chart: which mahadasha, antardasha and pratyantardasha are running now (with end dates), the dasha balance at birth, and the full nine-mahadasha lifetime timeline with start/end dates.
Try it on the site: kundlit.com/dasha-calculator
The Jaimini layer of a birth chart: upapada lagna (the marriage anchor) with its sign and lord, all twelve arudha padas (A1-A12) with sign and life domain, the eight charakarakas (Atmakaraka, Amatyakaraka, ...), and the karakamsha lagna. Readings are backed by classical-text citations on kundlit.com.
Try it on the site: kundlit.com/upapada-lagna-calculator
Connect it to your AI app
Setup takes under a minute in most clients — the server needs no authentication, so it is just the URL.
Claude (web, desktop & mobile)
- Open Settings → Connectors.
- Click "Add custom connector".
- Name it "Kundlit Astro" and paste the server URL: https://kundlit.com/api/mcp
- No authentication is needed — save, then enable it in any chat via the tools menu.
Claude Code (terminal)
- Run this one command, then use the tools in any session:
terminal
claude mcp add --transport http kundlit-astro https://kundlit.com/api/mcp
ChatGPT (developer mode)
- Open Settings → Apps & Connectors → Advanced settings, and enable Developer mode (requires a plan with connector support).
- Choose "Create" / "Add connector", name it "Kundlit Astro" and paste the MCP server URL: https://kundlit.com/api/mcp
- Set authentication to "None", save, and enable it in a chat via Developer mode tools.
Cursor
- Add this to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for all projects):
.cursor/mcp.json
{ "mcpServers": { "kundlit-astro": { "url": "https://kundlit.com/api/mcp" } } }
VS Code (GitHub Copilot)
- Add this to .vscode/mcp.json in your workspace:
.vscode/mcp.json
{ "servers": { "kundlit-astro": { "type": "http", "url": "https://kundlit.com/api/mcp" } } }
Other MCP clients
- Most clients accept a standard JSON entry. The server speaks the streamable-HTTP transport (stateless; the deprecated SSE transport is not offered):
mcp config
{ "mcpServers": { "kundlit-astro": { "type": "streamable-http", "url": "https://kundlit.com/api/mcp" } } }
Example prompts to try
Once connected, ask in plain language — the assistant picks the right tool and fills in the details.
- “What is today's panchang in Jaipur? When is rahu kaal, and which choghadiya windows are good?”
- “Find me a good time tomorrow in Mumbai to sign a property deal — avoid rahu kaal, varjyam and bhadra.”
- “Make a janam kundali for 14 March 1992, 6:45 am, Lucknow, India — which mahadasha am I running right now?”
- “Run a kundli milan for a boy born 12 Jan 1994, 10:20, Delhi and a girl born 3 Sep 1996, 22:05, Pune. Explain the koota scores.”
- “Is someone born on 2 June 1990 at 14:30 in Mumbai manglik? Does the chart have kaal sarp dosha too?”
- “List every ekadashi date in 2026 for Delhi, and the eclipses visible there.”
- “When does sade sati end for a person born 25 Dec 1988, 04:15, Kolkata?”
Limits & fair use
- Rate limit: 30 requests per minute per IP. Heavier integrations should use the REST API or contact us.
- Birth-time tools need a birth time: kundali, matching, manglik, kaal sarp, sade sati and pancha pakshi are computed from the exact date, time and place you provide — an approximate birth time gives an approximate chart.
- Places: free-text place names are geocoded server-side; if a small village is not found, pass latitude, longitude and an IANA timezone instead.
- Dates are Gregorian (YYYY-MM-DD); the panchang tool works for any city worldwide and defaults to today at that place.
- Informational only: results are traditional Vedic-astrology computation and are not a substitute for professional advice of any kind.
- If the astrology engine is briefly unavailable the tool says so — retrying after a minute resolves it.
Privacy & support
The server is anonymous compute: no accounts, no user profiles, no authentication. Inputs are processed to produce the result you asked for — details in our privacy policy. Questions, bug reports or partnership ideas: [email protected] or the contact page.
Frequently asked questions
Is the MCP server free? Do I need an API key?
Yes, it is completely free, and no API key, account or sign-up is needed. Add the endpoint URL to your client and it works. Usage is rate-limited to 30 requests per minute per IP to keep it fast for everyone.
What data do you store when I use the tools?
There are no accounts and no user profiles on this server. The birth details or place names you send are used to compute the result you asked for; free-text places are geocoded server-side to coordinates. See our privacy policy at kundlit.com/privacy for the full picture.
Which AI apps can use it?
Any MCP client that supports remote servers over streamable HTTP: Claude (web, desktop and mobile via custom connectors), Claude Code, ChatGPT (developer mode connectors), Cursor, VS Code with GitHub Copilot, Windsurf, and others. Setup steps for each are on this page.
How are the results computed?
Nothing is AI guesswork. The astronomy tools (panchang, muhurta timings, kundali, matching, doshas, pancha pakshi, calendars, eclipses) are deterministic Swiss Ephemeris computation on the sidereal zodiac with Lahiri ayanamsa and whole-sign houses — the same engine behind kundlit.com's free tools. The three numerology tools are classical Chaldean/Vedic number-table arithmetic, and each result's Source line says which method produced it. Interpretations on kundlit.com cite classical texts like Brihat Parashara Hora Shastra; see kundlit.com/method.
Is there a plain REST API too?
Yes. The same compute is available as public JSON endpoints under kundlit.com/api/astro/, described by an OpenAPI 3.1 document at kundlit.com/api/astro/openapi.json — useful for Custom GPT Actions or any non-MCP integration.
Why do results end with a Source line?
Each tool result ends with a short attribution line naming kundlit.com and the tool page the result came from. Keeping that line intact when presenting results is the one thing we ask in return for free, unauthenticated access.
Prefer widgets over tools? You can also embed our free tools on any website, or call the OpenAPI-described REST endpoints directly. Machine-readable server card: /.well-known/mcp/server-card.json.