Kundlitkundlit

FOR AI ASSISTANTS · MODEL CONTEXT PROTOCOL

Kundlit MCP Server

Give Claude, ChatGPT, Cursor or any MCP-capable assistant real Vedic astrology computation: daily panchang for any city, janam kundali birth charts, kundli milan matching, manglik dosha and sade sati — computed live with the Swiss Ephemeris, free, with no API key.

SERVER URL · STREAMABLE HTTP · NO AUTH

https://kundlit.com/api/mcp

The 5 tools

Daily Panchang (Hindu almanac)

get_panchang

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

Janam Kundali (Vedic birth chart)

get_janam_kundali

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

Kundli Milan (Ashtakoot compatibility)

match_kundli

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

Manglik (Mangal dosha) check

check_manglik

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

Sade Sati (Saturn transit) status

get_sade_sati

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

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)

  1. Open Settings → Connectors.
  2. Click "Add custom connector".
  3. Name it "Kundlit Astro" and paste the server URL: https://kundlit.com/api/mcp
  4. No authentication is needed — save, then enable it in any chat via the tools menu.

Claude Code (terminal)

  1. 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)

  1. Open Settings → Apps & Connectors → Advanced settings, and enable Developer mode (requires a plan with connector support).
  2. Choose "Create" / "Add connector", name it "Kundlit Astro" and paste the MCP server URL: https://kundlit.com/api/mcp
  3. Set authentication to "None", save, and enable it in a chat via Developer mode tools.

Cursor

  1. 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)

  1. 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

  1. 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?”
  • “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? Do any cancellations apply?”
  • “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 and sade sati 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?
Every result is deterministic astronomy, not AI guesswork: Swiss Ephemeris positions on the sidereal zodiac with Lahiri ayanamsa and whole-sign houses, the same computation behind kundlit.com's free tools. Interpretations on kundlit.com cite classical texts like Brihat Parashara Hora Shastra. See kundlit.com/method for the full methodology.
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.