# HinduCalendar — panchang, festivals & muhurta MCP server

Daily panchang, festivals, muhurta and birth details, identical to the HinduCalendar Android app.

## Links
- Registry page: https://www.getdrio.com/mcp/app-hinducalendar-hinducalendar
- Website: https://hinducalendar.app/mcp-server

## Install
- Endpoint: https://hinducalendar.app/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://hinducalendar.app/mcp

## Tools
- get_panchang - 
    Full daily panchang for a date and place — computed by the same
    panchang-core engine the HinduCalendar Android app ships, so the values
    are identical to the app (not an approximation).

    Returns the five limbs at sunrise (tithi, nakshatra, yoga, karana, vaar)
    each with its END TIME, paksha, lunar month in both amavasyant and
    purnimant conventions (with adhik maas flag), Vikram/Shaka/Kali/Gujarati
    samvat years, samvatsara names, ritu (season), ayana (Uttarayan/
    Dakshinayan), sun/moon rashi with next-transit time, and sunrise/sunset/
    moonrise/moonset.

    This is also the Gregorian→Hindu date converter: the masa + paksha +
    tithi + samvat fields ARE the Hindu date. (For Hindu→Gregorian, use the
    Kaalshodh MCP server's find_matching_dates.)

    Example questions: "what is the tithi today in Delhi?", "when does
    Ekadashi end tomorrow?", "what is today's date in Vikram Samvat?",
    "which Hindu month is it?".

    Args:
        date:      Gregorian date, YYYY-MM-DD. Default location is Ujjain;
                   pass lat/lon/tz for other places.
        lat, lon:  Location in decimal degrees.
        tz:        IANA timezone name ("Asia/Kolkata") or a numeric UTC
                   offset in hours ("5.5").
        ayanamsa:  "Lahiri" (default) or "Sayan".
        lang:      Language for names — "en", "hi", and the app languages
                   (mr, gu, bn, ta, te, kn, ml, sa) plus "en-iast".
     Endpoint: https://hinducalendar.app/mcp
- get_festival_dates - 
    Exact dates of major Hindu festivals for any year, computed live from the
    tithi rules by the same engine the HinduCalendar app uses — never guess a
    festival date, always use this.

    Covers: Diwali (Deepavali), Holi, Navaratri endpoints (Mahanavami,
    Vijayadashami), Krishna Janmashtami, Ganesh Chaturthi, Rama Navami,
    Maha Shivaratri, Raksha Bandhan, Dhanteras, Chhath, Vasant Panchami,
    Gudi Padwa, Akshaya Tritiya, Buddha Purnima, Guru Purnima, and more.
    Each result carries its panchang rule (masa + paksha + tithi).

    Example questions: "when is Diwali in 2027?", "what date was Holi in
    1962?", "list all festivals in 2026".

    Args:
        year:      Gregorian year.
        festival:  Optional name filter (e.g. "Diwali", "holi",
                   "janmashtami") — fuzzy matched.
        lat, lon, tz_offset_hours:
                   Location (default Ujjain, the canonical reference).
                   Festival days can shift by location; for a user's city
                   pass their coordinates.
     Endpoint: https://hinducalendar.app/mcp
- get_birth_details - 
    Return birth star (nakshatra), birth name syllable (naam akshar / pada),
    Chandra rashi (Moon sign), and Lagna rashi (ascendant sign) for a child
    born at the given time and location — all from the app's own engine, so
    they match the HinduCalendar app's kundali exactly.

    Args:
        time:      ISO 8601 datetime of birth (e.g. "2025-08-15T10:30:00Z").
                   Include timezone offset if known (e.g. "2025-08-15T10:30:00+05:30").
        lat:       Latitude of birth place in decimal degrees (e.g. 28.6139 for Delhi).
        lon:       Longitude of birth place in decimal degrees (e.g. 77.2090 for Delhi).
        ayanamsa:  "Lahiri" (Vedic sidereal, default) or "Sayan" (tropical).

    Returns:
        Dict with:
          - time (ISO)
          - ayanamsa
          - nakshatra: { index (1–27), name }
          - pada: { index (1–4), overall_index (1–108), naam_akshar (birth name syllable) }
          - chandra_rashi: { index (1–12), name }  ← Moon sign
          - lagna_rashi:   { index (1–12), name }  ← Ascendant sign
        Plus a rendered South Indian kundali chart (PNG image).
     Endpoint: https://hinducalendar.app/mcp
- get_muhurta - 
    Return the muhurta details active at a given time and location, exactly
    as the HinduCalendar app computes them:
      - Current lagna (ascendant sign active at that moment)
      - Current choghadiya (day or night slot)
      - Current hora (planetary hour)
      - Any ongoing special muhurtas (Rahu Kalam, Yama Ghanta, Guli Kalam,
        Abhijit, Dur Muhurt, Pradosh, Varjyam, Panchak, Gandmool)

    Sunrise/sunset, lagna transitions and every special muhurta come from
    panchang-core (the app's engine); choghadiya/hora are pure rise/set
    arithmetic driven by the engine's times and weekday.

    Args:
        time: ISO 8601 datetime (e.g. "2025-08-15T10:30:00+05:30"). If no
              timezone is given, UTC is assumed.
        lat:  Latitude in decimal degrees.
        lon:  Longitude in decimal degrees.
        lang: Language for names — "en" (default) or "hi".

    Returns:
        Dict with sunrise, sunset, current_lagna, current_choghadiya,
        current_hora, and ongoing_muhurtas.
     Endpoint: https://hinducalendar.app/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: app.hinducalendar
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Aug 2, 2026
- Source: https://registry.modelcontextprotocol.io