vedicproof
vedic proof · computation

Muhurta API

What is a Muhurta API?

A Muhurta API supplies the timing data an electional decision rests on: which tithi, vara, nakshatra, yoga and karana are running, and exactly when the Sun rises and sets. Vedic Proof publishes those inputs and the sunrise definition behind them; the muhurta rules themselves stay in your application.

Request

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

tool · get_panchang
{
  "date": "2026-11-12",
  "city": "Pune",
  "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
{
  "panchang": { "tithi": "Trayodashi", "paksha": "Shukla", "vara": "Thursday", "nakshatra": "Revati", "yoga": "Shukla", "karana": "Kaulava" },
  "sun": { "sunrise": "06:38", "sunset": "18:01", "day_length_hours": 11.38 }
}

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.

Sunrise definitionDisc centre, standard refraction, spherical horizon at sea level
Sunrise and sunset use an altitude of -0.833° (centre of the disc plus mean refraction), no elevation correction and no upper-limb variant. Engines using the upper limb or a terrain horizon will differ by minutes, which moves every panchang window.
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.

Common questions

Do you return named windows like Rahu Kaal or Abhijit?
Not yet as a dedicated field. Day length and precise sunrise and sunset are returned, which are the inputs those windows are divided from. We do not claim windows we do not compute.
Why does muhurta timing differ between apps?
Two reasons dominate: a different sunrise definition and a different timezone or DST resolution for the date. Both are pinned and published here.
Can I get panchang for a series of dates?
Call the tool once per date. Each call is a separate metered call, and there is no per-call fee on the subscription.

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 →