vedicproof
vedic proof · computation

Kundli API

What is a Kundli API?

A Kundli API generates a Vedic birth chart from a date, a time and a place. It returns the lagna, the nine grahas in sidereal longitude, the whole-sign houses, the janma nakshatra with its pada, panchang at birth and the Vimshottari dasha sequence, as structured data rather than an image.

Request

Tools are called over MCP, so an assistant connected to https://vedicproof.com/mcp invokes get_vedic_kundli itself. The arguments it sends are:

tool · get_vedic_kundli
{
  "date_of_birth": "1994-01-19",
  "time_of_birth": "05:22",
  "city": "Kochi",
  "country": "India"
}

Response

Every response carries a plain-language summary string plus structured data, and states the engine and ayanamsa it used. Abridged here for length.

result · json
{
  "lagna": { "rasi": "Dhanu", "degree": "12° 41' 08\"", "lord": "Jupiter" },
  "planets": [
    { "graha": "Sun", "rasi": "Makara", "degree": "5° 02' 44\"", "nakshatra": "Uttara Ashadha", "pada": 3, "house": 2, "retrograde": false }
  ],
  "panchang_at_birth": { "tithi": "Ashtami", "paksha": "Krishna", "vara": "Wednesday", "yoga": "Shubha", "karana": "Balava" },
  "vimshottari_dasha": [ { "lord": "Rahu", "from": "1993-04-02", "to": "2011-04-02", "running": true } ]
}

How is this calculated and verified?

These are the pinned parameters that affect this computation. The full disclosure, and the golden-chart corpus, live on /proof.

AyanamsaLahiri (Chitrapaksha), mean
Single supported system today, computed as a polynomial in Julian centuries from J2000 rather than read from a table. True-Chitra, KP-Newcomb and Raman are not offered; that is a limitation, not a default we are hiding.
House systemWhole sign (rasi bhava)
The lagna rasi is the first bhava in full; every graha's house is its rasi counted from the lagna rasi. Placidus, Sripati and KP cusps are not offered.
Time handlingIANA tzdata via the host Intl database, DST-aware
Offsets are resolved for the birth instant, not for today, so historical DST rules apply wherever the host tzdata carries them. There is no Local Mean Time fallback for births before standard time: a pre-standard-time birth is treated as standard offset. An unknown birth time defaults to 12:00 local and the response flags time_assumed: true and states that the lagna is unreliable.
Rounding and boundariesAssigned on unrounded longitude; displayed to the arc-minute
Rasi, nakshatra and pada are assigned from the full-precision longitude before any rounding, so a graha at 29.9999° stays in its own rasi. Degrees are formatted d° mm' ss" for display only.

Common questions

What if the birth time is unknown?
The API assumes 12:00 local, sets time_assumed to true, and says in the summary that the lagna is unreliable. Rasi and nakshatra of the Moon stay usable; house placements do not.
Can I pass coordinates instead of a city?
Yes. Send latitude, longitude and an IANA timezone and no geocoding happens. City plus country is geocoded for you.
Do you return a chart image?
No. The response is JSON plus a plain-language summary string, which is what an assistant or an application needs to render its own chart.

Connect this to Claude or ChatGPT with one URL: https://vedicproof.com/mcp. First 14 days unlimited and free, then $1.99/month.

claude setup →chatgpt setup →pricing →

Related computations

all computations in docs →