{"openapi":"3.1.0","info":{"title":"Panchang API","version":"0.1.0","description":"Daily Hindu panchang, muhurta, Choghadiya, Hora, festivals and vrats, Ekadashi/Purnima/Amavasya, Hindu date conversion, sankranti, birth rashi and nakshatra — computed locally for any place.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://panchang.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/panchang/docs"},"termsOfService":"https://connectorbay.com/panchang/terms"},"servers":[{"url":"https://panchang.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/panchang/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/panchang":{"post":{"operationId":"panchang","summary":"The full daily panchang for a place: tithi (with start/end), nakshatra (pada, lord, end), yoga, karana, vaara,","description":"The full daily panchang for a place: tithi (with start/end), nakshatra (pada, lord, end), yoga, karana, vaara,\n    paksha, amanta/purnimanta month with adhika flag, Vikram and Shaka samvat, ritu, ayana, sunrise, sunset,\n    moonrise, moonset, moon illumination, moon and sun rashi, plus Rahu Kaal, Yamaganda, Gulika, Abhijit and Brahma\n    Muhurta. Use for \"aaj ka panchang\", \"today's tithi and nakshatra in Toronto\", \"panchang for 8 Nov 2026 in Mumbai\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date_str":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD, 'today' or 'tomorrow' (default today at the place).","examples":["2026-11-08"],"title":"Date Str"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City, optionally with state/country (default New Delhi).","examples":["Mumbai","Chicago, IL","London, UK"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"}},"title":"panchangArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/muhurta":{"post":{"operationId":"muhurta","summary":"Inauspicious and auspicious periods for a day: Rahu Kaal, Yamaganda, Gulika Kaal (avoid), Abhijit Muhurta,","description":"Inauspicious and auspicious periods for a day: Rahu Kaal, Yamaganda, Gulika Kaal (avoid), Abhijit Muhurta,\n    Brahma Muhurta, Pradosh Kaal, Nishita Kaal, plus Vishti/Bhadra karana hours and a quick verdict on the day's\n    nakshatra and yoga. Use for \"Rahu Kaal today in Chicago\", \"good time to start something tomorrow\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date_str":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD, 'today' or 'tomorrow'.","title":"Date Str"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City (default New Delhi).","examples":["Bengaluru","New York"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"}},"title":"muhurtaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/choghadiya":{"post":{"operationId":"choghadiya","summary":"Day and night Choghadiya (eight slots each) with quality: Amrit, Shubh, Labh, Char are good; Udveg, Kaal, Rog","description":"Day and night Choghadiya (eight slots each) with quality: Amrit, Shubh, Labh, Char are good; Udveg, Kaal, Rog\n    are avoided. Use for \"good Choghadiya this afternoon in Ahmedabad\", \"Choghadiya tomorrow night\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date_str":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD, 'today' or 'tomorrow'.","title":"Date Str"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City (default New Delhi).","title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"}},"title":"choghadiyaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hora":{"post":{"operationId":"hora","summary":"The 24 planetary hours (Hora) from sunrise to next sunrise: ruling planet, times and what each favours. Use for","description":"The 24 planetary hours (Hora) from sunrise to next sunrise: ruling planet, times and what each favours. Use for\n    \"Jupiter hora today\", \"which hora is good for business this morning\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date_str":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD, 'today' or 'tomorrow'.","title":"Date Str"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City (default New Delhi).","title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"}},"title":"horaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/festivals":{"post":{"operationId":"festivals","summary":"Hindu festival and vrat dates computed from tithi, nakshatra and sankranti rules: Diwali, Holi, Navaratri and","description":"Hindu festival and vrat dates computed from tithi, nakshatra and sankranti rules: Diwali, Holi, Navaratri and\n    Dussehra, Janmashtami, Ganesh Chaturthi, Raksha Bandhan, Maha Shivaratri, Rama Navami, Makar Sankranti,\n    Baisakhi/Vishu, Onam, Chhath, Karva Chauth, Guru Purnima and more (plus Ekadashis on request). Use for \"when is\n    Diwali 2027\", \"festivals in October\", \"next 5 festivals\", \"Holi date next year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"year":{"anyOf":[{"maximum":2100,"minimum":1900,"type":"integer"},{"type":"null"}],"default":null,"description":"Year (default current).","title":"Year"},"month":{"anyOf":[{"maximum":12,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Restrict to a Gregorian month 1–12.","title":"Month"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Festival name to find, e.g. Diwali, Holi, Navaratri.","examples":["Diwali"],"title":"Query"},"upcoming":{"anyOf":[{"maximum":30,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Instead: the next N festivals from today.","title":"Upcoming"},"include_ekadashi":{"default":false,"description":"Include the 24–26 Ekadashi fasts.","title":"Include Ekadashi","type":"boolean"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City used for sunrise-based day selection (default New Delhi).","title":"Place"}},"title":"festivalsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/ekadashi":{"post":{"operationId":"ekadashi","summary":"Upcoming Ekadashi fasts (with their names), Purnima, Amavasya, Pradosh vrat or Sankashti Chaturthi dates.","description":"Upcoming Ekadashi fasts (with their names), Purnima, Amavasya, Pradosh vrat or Sankashti Chaturthi dates.\n    Use for \"next Ekadashi\", \"Purnima dates this year\", \"when is the next Amavasya\", \"Sankashti Chaturthi in March\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"from_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD (default today).","title":"From Date"},"count":{"default":6,"maximum":30,"minimum":1,"title":"Count","type":"integer"},"kind":{"default":"ekadashi","description":"ekadashi | purnima | amavasya | pradosh | sankashti","title":"Kind","type":"string"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City (default New Delhi).","title":"Place"}},"title":"ekadashiArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hindu_date":{"post":{"operationId":"hindu_date","summary":"Convert a Gregorian date to the Hindu lunisolar date: tithi, paksha, amanta and purnimanta month (adhika),","description":"Convert a Gregorian date to the Hindu lunisolar date: tithi, paksha, amanta and purnimanta month (adhika),\n    Vikram Samvat (Chaitra-adi and Kartika-adi), Shaka Samvat, Kali Yuga year, ritu, ayana and the solar (sidereal)\n    month. Use for \"what is today's date in Vikram Samvat\", \"Hindu date for 15 August 1947\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date_str":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Gregorian date YYYY-MM-DD (default today).","title":"Date Str"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City (default New Delhi).","title":"Place"}},"title":"hindu_dateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_tithi":{"post":{"operationId":"find_tithi","summary":"Find the Gregorian date of a Hindu lunar date (month + paksha + tithi) in a year — birthdays by tithi,","description":"Find the Gregorian date of a Hindu lunar date (month + paksha + tithi) in a year — birthdays by tithi,\n    shraddha dates, regional festivals not in the list. Use for \"Kartika Shukla Ekadashi 2027\", \"my tithi birthday\n    Bhadrapada Krishna Panchami this year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"year":{"maximum":2100,"minimum":1900,"title":"Year","type":"integer"},"month":{"description":"Amanta month: Chaitra, Vaishakha, Jyeshtha, Ashadha, Shravana, Bhadrapada, Ashwina, Kartika, Margashirsha, Pausha, Magha, Phalguna.","examples":["Kartika"],"title":"Month","type":"string"},"paksha":{"description":"shukla | krishna","title":"Paksha","type":"string"},"tithi":{"description":"1–15 (15 = Purnima or Amavasya).","maximum":15,"minimum":1,"title":"Tithi","type":"integer"},"rule":{"default":"udaya","description":"udaya | madhyahna | aparahna | pradosh | nishita","title":"Rule","type":"string"},"purnimanta":{"default":false,"description":"Treat the month name as purnimanta (north-Indian) instead of amanta.","title":"Purnimanta","type":"boolean"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City (default New Delhi).","title":"Place"}},"required":["year","month","paksha","tithi"],"title":"find_tithiArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/sankranti":{"post":{"operationId":"sankranti","summary":"All twelve sankrantis (the sidereal Sun entering each rashi) in a year with local times, the solar-month names","description":"All twelve sankrantis (the sidereal Sun entering each rashi) in a year with local times, the solar-month names\n    and the festival each one marks (Makar Sankranti/Pongal, Mesha Sankranti/Baisakhi/Vishu…). Use for \"Makar\n    Sankranti time 2027\", \"when does Uttarayana begin\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"year":{"anyOf":[{"maximum":2100,"minimum":1900,"type":"integer"},{"type":"null"}],"default":null,"title":"Year"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City for local times (default New Delhi).","title":"Place"}},"title":"sankrantiArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/birth_rashi":{"post":{"operationId":"birth_rashi","summary":"Moon sign (chandra/janma rashi), birth nakshatra with pada and name syllables, sidereal sun sign, tithi and","description":"Moon sign (chandra/janma rashi), birth nakshatra with pada and name syllables, sidereal sun sign, tithi and\n    vaara at birth — the basics for a Vedic chart or naming ceremony. Use for \"my rashi if born 14 March 1990 at\n    6:30 in Pune\", \"what nakshatra was I born under\". Not a full horoscope (no lagna/houses).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"birth_datetime":{"description":"Local date-time of birth, YYYY-MM-DDTHH:MM.","examples":["1990-03-14T06:30"],"title":"Birth Datetime","type":"string"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Birth place (default New Delhi).","examples":["Pune"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"}},"required":["birth_datetime"],"title":"birth_rashiArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/nakshatra_info":{"post":{"operationId":"nakshatra_info","summary":"Reference facts for a nakshatra (deity, symbol, lord, gana, rashi, name syllables, nature) or a rashi (lord,","description":"Reference facts for a nakshatra (deity, symbol, lord, gana, rashi, name syllables, nature) or a rashi (lord,\n    element, quality, symbol, nakshatras) — or the full lists. Use for \"tell me about Rohini nakshatra\", \"which\n    letters for a child born in Ashwini\", \"who rules Vrishabha\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nakshatra name (or part).","examples":["Rohini","Pushya"],"title":"Name"},"rashi":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Rashi name in Sanskrit or English.","examples":["Vrishabha","Leo"],"title":"Rashi"}},"title":"nakshatra_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/month_calendar":{"post":{"operationId":"month_calendar","summary":"A day-by-day table for a Gregorian month: tithi and paksha at sunrise, nakshatra, amanta month, sunrise and","description":"A day-by-day table for a Gregorian month: tithi and paksha at sunrise, nakshatra, amanta month, sunrise and\n    sunset, with festivals marked. Use for \"panchang calendar for November 2026\", \"tithis in March\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"year":{"maximum":2100,"minimum":1900,"title":"Year","type":"integer"},"month":{"maximum":12,"minimum":1,"title":"Month","type":"integer"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City (default New Delhi).","title":"Place"}},"required":["year","month"],"title":"month_calendarArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}