{"$schema":"https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json","version":"1.0","protocolVersion":"2025-06-18","supportedVersions":["2026-07-28","2025-06-18","2025-03-26"],"endpoints":[{"transport":"streamable-http","url":"https://fatcalendar.com/mcp"}],"mcpServers":{"fatcalendar":{"url":"https://fatcalendar.com/mcp"}},"serverInfo":{"name":"fatcalendar","title":"fatcalendar","version":"1.0.0"},"description":"fatcalendar.com is a free calendar for Gregorian, Telugu, Tamil, Kannada, Malayalam, Marathi, Gujarati, Punjabi, Bengali, North-Indian (Hindi), Indian-Muslim (Hijri) and Christian traditions (12), shown in eleven languages, with tithi, nakshatra, festivals, auspicious windows and prayer times computed for your location. Free REST API, MCP server, A2A agent and SDK.","iconUrl":"https://fatcalendar.com/favicon.svg","documentationUrl":"https://fatcalendar.com/docs/mcp","homepage":"https://fatcalendar.com","contact":{"name":"fatcalendar","email":"hello@fatcalendar.com","url":"https://fatcalendar.com/contact"},"transport":{"type":"streamable-http","endpoint":"https://fatcalendar.com/mcp","url":"https://fatcalendar.com/mcp"},"capabilities":{"tools":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false},"prompts":{"listChanged":false}},"authentication":{"required":false,"schemes":[]},"auth":{"type":"none","required":false},"instructions":"Read-only calendar and panchang tools; no authentication. Rate limit 120 requests per 60s per client.","tools":[{"name":"get_month","title":"Get a month calendar","description":"Returns every day cell of a month (with leading/trailing days of adjacent months) in the requested tradition and language: traditional date, tithi, nakshatra, moon phase, markers (purnima, amavasya, ekadashi, sankranti...), festivals and holidays, plus a localized header with era names (Shaka, Vikram, Kollavarsham, Hijri...).","inputSchema":{"type":"object","properties":{"tradition":{"default":"gregorian","description":"Calendar tradition. One of: gregorian, telugu, tamil, kannada, malayalam, marathi, gujarati, punjabi, bengali, hindi, muslim, christian.","type":"string","enum":["gregorian","telugu","tamil","kannada","malayalam","marathi","gujarati","punjabi","bengali","hindi","muslim","christian"]},"lang":{"default":"en","description":"Display language (independent of tradition): en, te, ta, kn, ml, mr, gu, pa, bn, hi, ur.","type":"string","enum":["en","te","ta","kn","ml","mr","gu","pa","bn","hi","ur"]},"digits":{"description":"Digit script for numbers in the response: latin (default) or native (e.g. Telugu or Tamil numerals).","type":"string","enum":["latin","native"]},"variant":{"description":"Optional tradition sub-variant (default per tradition; see GET /api/v1/traditions). Valid: tamil: thirukanitha|vakya; kannada: smarta|madhva; malayalam: default|nazhika; punjabi: nanakshahi|desi|hindu; bengali: west-bengal-bisuddha|west-bengal-gupta|bangladesh; hindi: purnimanta|amanta|varanasi|braj|awadh; muslim: india|astronomical|tabular|hanafi|shia; christian: western|orthodox|catholic|protestant.","type":"string","minLength":1,"maxLength":32},"lat":{"description":"Latitude in decimal degrees (-90..90). Use with lon and tz.","type":"number","minimum":-90,"maximum":90},"lon":{"description":"Longitude in decimal degrees (-180..180). Use with lat and tz.","type":"number","minimum":-180,"maximum":180},"tz":{"description":"IANA time zone, e.g. Asia/Kolkata.","type":"string","minLength":1,"maxLength":64},"place":{"description":"Free-text place name (e.g. \"Hyderabad\"); resolved via the geocoder, first hit wins. Alternative to lat/lon/tz.","type":"string","minLength":2,"maxLength":120},"year":{"description":"Gregorian year, 1900-2200. Defaults to the current year.","type":"integer","minimum":1900,"maximum":2200},"month":{"description":"Gregorian month 1-12. Defaults to the current month.","type":"integer","minimum":1,"maximum":12}}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true}},{"name":"get_week","title":"Get a week calendar","description":"Returns the seven day cells of the Sunday-to-Saturday week containing `date`, in the requested tradition and language.","inputSchema":{"type":"object","properties":{"tradition":{"default":"gregorian","description":"Calendar tradition. One of: gregorian, telugu, tamil, kannada, malayalam, marathi, gujarati, punjabi, bengali, hindi, muslim, christian.","type":"string","enum":["gregorian","telugu","tamil","kannada","malayalam","marathi","gujarati","punjabi","bengali","hindi","muslim","christian"]},"lang":{"default":"en","description":"Display language (independent of tradition): en, te, ta, kn, ml, mr, gu, pa, bn, hi, ur.","type":"string","enum":["en","te","ta","kn","ml","mr","gu","pa","bn","hi","ur"]},"digits":{"description":"Digit script for numbers in the response: latin (default) or native (e.g. Telugu or Tamil numerals).","type":"string","enum":["latin","native"]},"variant":{"description":"Optional tradition sub-variant (default per tradition; see GET /api/v1/traditions). Valid: tamil: thirukanitha|vakya; kannada: smarta|madhva; malayalam: default|nazhika; punjabi: nanakshahi|desi|hindu; bengali: west-bengal-bisuddha|west-bengal-gupta|bangladesh; hindi: purnimanta|amanta|varanasi|braj|awadh; muslim: india|astronomical|tabular|hanafi|shia; christian: western|orthodox|catholic|protestant.","type":"string","minLength":1,"maxLength":32},"lat":{"description":"Latitude in decimal degrees (-90..90). Use with lon and tz.","type":"number","minimum":-90,"maximum":90},"lon":{"description":"Longitude in decimal degrees (-180..180). Use with lat and tz.","type":"number","minimum":-180,"maximum":180},"tz":{"description":"IANA time zone, e.g. Asia/Kolkata.","type":"string","minLength":1,"maxLength":64},"place":{"description":"Free-text place name (e.g. \"Hyderabad\"); resolved via the geocoder, first hit wins. Alternative to lat/lon/tz.","type":"string","minLength":2,"maxLength":120},"date":{"description":"Civil date YYYY-MM-DD. Defaults to today in the location time zone.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true}},{"name":"get_year","title":"Get a year calendar","description":"Returns all twelve months of a Gregorian year (compact day cells with moon phase and markers, plus the list of festivals per month) in the requested tradition and language.","inputSchema":{"type":"object","properties":{"tradition":{"default":"gregorian","description":"Calendar tradition. One of: gregorian, telugu, tamil, kannada, malayalam, marathi, gujarati, punjabi, bengali, hindi, muslim, christian.","type":"string","enum":["gregorian","telugu","tamil","kannada","malayalam","marathi","gujarati","punjabi","bengali","hindi","muslim","christian"]},"lang":{"default":"en","description":"Display language (independent of tradition): en, te, ta, kn, ml, mr, gu, pa, bn, hi, ur.","type":"string","enum":["en","te","ta","kn","ml","mr","gu","pa","bn","hi","ur"]},"digits":{"description":"Digit script for numbers in the response: latin (default) or native (e.g. Telugu or Tamil numerals).","type":"string","enum":["latin","native"]},"variant":{"description":"Optional tradition sub-variant (default per tradition; see GET /api/v1/traditions). Valid: tamil: thirukanitha|vakya; kannada: smarta|madhva; malayalam: default|nazhika; punjabi: nanakshahi|desi|hindu; bengali: west-bengal-bisuddha|west-bengal-gupta|bangladesh; hindi: purnimanta|amanta|varanasi|braj|awadh; muslim: india|astronomical|tabular|hanafi|shia; christian: western|orthodox|catholic|protestant.","type":"string","minLength":1,"maxLength":32},"lat":{"description":"Latitude in decimal degrees (-90..90). Use with lon and tz.","type":"number","minimum":-90,"maximum":90},"lon":{"description":"Longitude in decimal degrees (-180..180). Use with lat and tz.","type":"number","minimum":-180,"maximum":180},"tz":{"description":"IANA time zone, e.g. Asia/Kolkata.","type":"string","minLength":1,"maxLength":64},"place":{"description":"Free-text place name (e.g. \"Hyderabad\"); resolved via the geocoder, first hit wins. Alternative to lat/lon/tz.","type":"string","minLength":2,"maxLength":120},"year":{"description":"Gregorian year, 1900-2200. Defaults to the current year.","type":"integer","minimum":1900,"maximum":2200}}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true}},{"name":"get_day","title":"Get a full day (panchang) view","description":"Returns the full daily almanac for one civil date: vara, tithi, nakshatra, yoga, karana (each with end times), paksha, lunar month, samvatsara, sunrise/sunset/moonrise/moonset, auspicious and inauspicious windows (Rahu Kalam, Yamagandam, Gulika, Abhijit, Brahma Muhurta, Varjyam, Durmuhurtham, Amrita...), Choghadiya, Hijri date and prayer times (muslim tradition), and festivals.","inputSchema":{"type":"object","properties":{"tradition":{"default":"gregorian","description":"Calendar tradition. One of: gregorian, telugu, tamil, kannada, malayalam, marathi, gujarati, punjabi, bengali, hindi, muslim, christian.","type":"string","enum":["gregorian","telugu","tamil","kannada","malayalam","marathi","gujarati","punjabi","bengali","hindi","muslim","christian"]},"lang":{"default":"en","description":"Display language (independent of tradition): en, te, ta, kn, ml, mr, gu, pa, bn, hi, ur.","type":"string","enum":["en","te","ta","kn","ml","mr","gu","pa","bn","hi","ur"]},"digits":{"description":"Digit script for numbers in the response: latin (default) or native (e.g. Telugu or Tamil numerals).","type":"string","enum":["latin","native"]},"variant":{"description":"Optional tradition sub-variant (default per tradition; see GET /api/v1/traditions). Valid: tamil: thirukanitha|vakya; kannada: smarta|madhva; malayalam: default|nazhika; punjabi: nanakshahi|desi|hindu; bengali: west-bengal-bisuddha|west-bengal-gupta|bangladesh; hindi: purnimanta|amanta|varanasi|braj|awadh; muslim: india|astronomical|tabular|hanafi|shia; christian: western|orthodox|catholic|protestant.","type":"string","minLength":1,"maxLength":32},"lat":{"description":"Latitude in decimal degrees (-90..90). Use with lon and tz.","type":"number","minimum":-90,"maximum":90},"lon":{"description":"Longitude in decimal degrees (-180..180). Use with lat and tz.","type":"number","minimum":-180,"maximum":180},"tz":{"description":"IANA time zone, e.g. Asia/Kolkata.","type":"string","minLength":1,"maxLength":64},"place":{"description":"Free-text place name (e.g. \"Hyderabad\"); resolved via the geocoder, first hit wins. Alternative to lat/lon/tz.","type":"string","minLength":2,"maxLength":120},"date":{"description":"Civil date YYYY-MM-DD. Defaults to today in the location time zone.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true}},{"name":"get_panchang","title":"Get the raw normalised panchang","description":"Returns the language- and tradition-independent astronomical record for one civil date at a location: sunrise/sunset, tithi(s), nakshatra(s), yoga(s), karana(s) with ISO-8601 UTC start/end instants, Amanta lunar month, Shaka year, sidereal longitudes and the Rahu/Yamagandam/Gulika periods. Derived from the jotish.ai ephemeris.","inputSchema":{"type":"object","properties":{"lat":{"description":"Latitude in decimal degrees (-90..90). Use with lon and tz.","type":"number","minimum":-90,"maximum":90},"lon":{"description":"Longitude in decimal degrees (-180..180). Use with lat and tz.","type":"number","minimum":-180,"maximum":180},"tz":{"description":"IANA time zone, e.g. Asia/Kolkata.","type":"string","minLength":1,"maxLength":64},"place":{"description":"Free-text place name (e.g. \"Hyderabad\"); resolved via the geocoder, first hit wins. Alternative to lat/lon/tz.","type":"string","minLength":2,"maxLength":120},"date":{"description":"Civil date YYYY-MM-DD. Defaults to today in the location time zone.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true}},{"name":"list_festivals","title":"List festivals of a year","description":"Lists every festival, vrata, fast, holiday, gurpurab and feast of a Gregorian year for a tradition, each with its civil date, name in the requested language, English name, kind, whether it is major, and the rule that determines the date (e.g. \"Kartika Amavasya at sunrise\").","inputSchema":{"type":"object","properties":{"tradition":{"default":"gregorian","description":"Calendar tradition. One of: gregorian, telugu, tamil, kannada, malayalam, marathi, gujarati, punjabi, bengali, hindi, muslim, christian.","type":"string","enum":["gregorian","telugu","tamil","kannada","malayalam","marathi","gujarati","punjabi","bengali","hindi","muslim","christian"]},"lang":{"default":"en","description":"Display language (independent of tradition): en, te, ta, kn, ml, mr, gu, pa, bn, hi, ur.","type":"string","enum":["en","te","ta","kn","ml","mr","gu","pa","bn","hi","ur"]},"digits":{"description":"Digit script for numbers in the response: latin (default) or native (e.g. Telugu or Tamil numerals).","type":"string","enum":["latin","native"]},"variant":{"description":"Optional tradition sub-variant (default per tradition; see GET /api/v1/traditions). Valid: tamil: thirukanitha|vakya; kannada: smarta|madhva; malayalam: default|nazhika; punjabi: nanakshahi|desi|hindu; bengali: west-bengal-bisuddha|west-bengal-gupta|bangladesh; hindi: purnimanta|amanta|varanasi|braj|awadh; muslim: india|astronomical|tabular|hanafi|shia; christian: western|orthodox|catholic|protestant.","type":"string","minLength":1,"maxLength":32},"lat":{"description":"Latitude in decimal degrees (-90..90). Use with lon and tz.","type":"number","minimum":-90,"maximum":90},"lon":{"description":"Longitude in decimal degrees (-180..180). Use with lat and tz.","type":"number","minimum":-180,"maximum":180},"tz":{"description":"IANA time zone, e.g. Asia/Kolkata.","type":"string","minLength":1,"maxLength":64},"place":{"description":"Free-text place name (e.g. \"Hyderabad\"); resolved via the geocoder, first hit wins. Alternative to lat/lon/tz.","type":"string","minLength":2,"maxLength":120},"year":{"description":"Gregorian year, 1900-2200. Defaults to the current year.","type":"integer","minimum":1900,"maximum":2200}}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true}},{"name":"search_places","title":"Search places (geocoder)","description":"Free-text place search (city, town, region). Returns candidates with label, latitude, longitude and IANA time zone, ready to pass as lat/lon/tz to the calendar operations.","inputSchema":{"type":"object","properties":{"q":{"type":"string","minLength":2,"maxLength":120,"description":"Place name to search, e.g. \"Vijayawada\"."}},"required":["q"]},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true}},{"name":"list_traditions","title":"List calendar traditions","description":"Lists the 12 supported traditions with id, name, region, default language, calendar system, a summary, the available `variants` ({id,name,description}) and `defaultVariant`. Pass a variant id as the `variant` parameter of calendar operations.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true}},{"name":"list_languages","title":"List display languages","description":"Lists the 11 display languages (en, te, ta, kn, ml, mr, gu, pa, bn, hi, ur) with native and English names, BCP-47 tag and text direction. Any tradition can be shown in any language.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true}},{"name":"ask","title":"Ask a calendar question","description":"Answer a natural-language calendar question (NLWeb-style). Parses tradition, date, place and festival from the text and returns schema.org-style results backed by the same data as the other tools. Prefer the specific tools when you know the parameters.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":2,"maxLength":500,"description":"Natural-language calendar question, e.g. \"When is Diwali in 2026?\" or \"Telugu panchang for tomorrow in Hyderabad\"."}},"required":["query"]},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true}}],"resources":[{"uri":"fatcalendar://traditions","name":"traditions","mimeType":"application/json"},{"uri":"fatcalendar://languages","name":"languages","mimeType":"application/json"}],"prompts":[{"name":"explain_day","description":"Explain the panchang and festivals of a day in plain language.","arguments":[{"name":"date","required":false},{"name":"tradition","required":false},{"name":"place","required":false}]}],"examples":["What is the tithi and nakshatra in Hyderabad on 2026-11-08?","Show me the Telugu calendar for November 2026","When is Diwali in 2026?","Rahu Kalam today in Chennai","Hijri date and prayer times in Hyderabad tomorrow"]}