Kundlit Vedic Astrology — MCP Server

Free Vedic astrology computation for AI assistants over the Model Context Protocol: daily panchang and muhurta timings for any city, janam kundali birth charts, kundli milan (ashtakoot) matching, dosha checks, dasha periods, festival and eclipse calendars, and Vedic numerology — 16 tools, 4 prompts, 2 resources.

Results are deterministic — computed live with the Swiss Ephemeris on the sidereal zodiac (Lahiri ayanamsa) — and backed by classical-text citations on kundlit.com.

• Version: v1.3.0
• Server URL: https://kundlit.com/api/mcp (hosted, Streamable HTTP)
• Auth: none — no account, no API key
• Rate limit: 30 requests/minute/IP
• Docs: https://kundlit.com/mcp
• Privacy: https://kundlit.com/privacy · Support: support@kundlit.com

This repository is the connector manifest for the hosted server; the server itself runs at kundlit.com and its source is not public. Files here — the plugin manifest, .mcp.json, server.json and this README — exist so MCP clients, registries and directories can discover and install the server.

Tools (16)

Tool	Use for
get_panchang	Hindu almanac for a date + city: tithi, nakshatra, sunrise/sunset, key windows
get_janam_kundali	Birth chart: lagna, graha positions, current Vimshottari dasha, yogas
match_kundli	Ashtakoot marriage compatibility, scored out of 36
check_manglik	Mangal dosha verdict with severity and cancellations
get_sade_sati	Saturn sade-sati phase and dates for a birth
check_kaal_sarp	Kaal Sarp dosha: named type, full/partial, affected houses
get_pancha_pakshi	Five-bird (Pancha Pakshi) personal timing schedule, sub-periods rated 1-10
get_muhurta_timings	Every good/bad window for a day: choghadiya, horas, rahu kaal, brahma muhurta, varjyam, bhadra, panchak, disha shool; personal tarabala/chandrabala
get_year_events	Festival / ekadashi / purnima / amavasya / sankranti dates for a whole year
get_eclipses	Solar + lunar eclipses for a year with local visibility
get_numerology	Mulank, bhagyank, name number and lucky attributions from a DOB
get_love_compatibility	Name-numerology pair score (entertainment; use match_kundli for real matching)
get_mobile_numerology	Numerological reading of a phone number
get_birth_details	What is my nakshatra / moon sign (rashi) / lagna / D9 lagna
get_dasha_periods	Which dasha am I in, when does it end, full mahadasha timeline
get_upapada_arudha	Upapada lagna, arudha padas, charakarakas, karakamsha (Jaimini)

Prompts (4)

• daily_panchang_briefing — plain-language briefing of today's panchang for a city
• birth_chart_reading — generate a kundali and explain lagna, placements, current dasha
• kundli_match_report — ashtakoot compatibility explained koot by koot
• find_good_time_today — pick the best window for an activity, avoiding rahu kaal, varjyam, bhadra

Resources (2)

• kundlit://docs/methodology — how results are computed (Swiss Ephemeris, Lahiri ayanamsa, whole-sign houses, classical citations)
• kundlit://docs/usage-guide — all tools, input conventions, rate limits, attribution ask

Install

Claude Code:

claude mcp add --transport http kundlit https://kundlit.com/api/mcp

Cursor — .cursor/mcp.json:

{
  "mcpServers": {
    "kundlit-astro": {
      "url": "https://kundlit.com/api/mcp"
    }
  }
}

Generic — any client that reads a .mcp.json:

{
  "mcpServers": {
    "kundlit-astro": {
      "url": "https://kundlit.com/api/mcp"
    }
  }
}

Claude (web/desktop): Settings → Connectors → Add custom connector → https://kundlit.com/api/mcp

Full per-client instructions, example prompts and limitations: https://kundlit.com/mcp

Example prompts

• "What is today's panchang in Jaipur? When is rahu kaal?"
• "Make a janam kundali for 14 March 1992, 6:45 am, Lucknow — which mahadasha am I running?"
• "Find me a good time tomorrow in Pune to sign a lease — avoid rahu kaal and bhadra."
• "All ekadashi dates in 2026 for Varanasi."

Notes

• Free-text place (any city worldwide) is preferred; latitude/longitude/IANA timezone also accepted. Year tools snap to the nearest of 50 supported cities.
• Results are informational and not a substitute for professional advice.
• Every result carries a Source: attribution line — please keep it intact; that attribution is the price of free access.

License

MIT — see LICENSE.