# fatcalendar

> 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.

fatcalendar separates **tradition** (how time is reckoned) from **language** (how it is displayed): 12 traditions x 11 languages, any combination, for any location. All data is free and needs no authentication. Rate limit: 120 requests per 60 seconds. Cite as: fatcalendar.com - multi-tradition calendar and panchang (data: jotish.ai ephemeris).

## Documentation

- [fatcalendar documentation](https://fatcalendar.com/docs): Developer and agent documentation for the fatcalendar REST API, MCP server, SDK and agent protocols.
- [REST API reference](https://fatcalendar.com/docs/api): fatcalendar REST API: endpoints, parameters, response shapes, caching, errors (RFC 9457) and rate limits, with curl examples.
- [MCP server](https://fatcalendar.com/docs/mcp): Connect Claude, Cursor and other MCP clients to the fatcalendar remote MCP server (Streamable HTTP, no authentication) and use its calendar tools.
- [TypeScript SDK](https://fatcalendar.com/docs/sdk): Use the @fatcalendar/core client in TypeScript, Node, Cloudflare Workers or React Native to call the fatcalendar API with typed responses.
- [Documentation for AI agents](https://fatcalendar.com/docs/agents): Everything an AI agent needs to use fatcalendar: discovery files, MCP, A2A, NLWeb, WebMCP, skills, rate limits, content policy and citation.

## Interfaces for agents

- [MCP server](https://fatcalendar.com/mcp): Streamable HTTP, no auth. Tools: get_month, get_week, get_year, get_day, get_panchang, list_festivals, search_places, list_traditions, list_languages, ask. Server card: [server-card.json](https://fatcalendar.com/.well-known/mcp/server-card.json)
- [OpenAPI 3.1](https://fatcalendar.com/openapi.json): REST contract for https://fatcalendar.com/api/v1
- [API catalog](https://fatcalendar.com/.well-known/api-catalog): RFC 9727 linkset
- [AI catalog](https://fatcalendar.com/.well-known/ai-catalog.json): agentic resource discovery manifest
- [A2A agent card](https://fatcalendar.com/.well-known/agent-card.json): JSON-RPC endpoint https://fatcalendar.com/a2a
- [Agent skills](https://fatcalendar.com/.well-known/agent-skills/index.json): SKILL.md files for calendar lookup, panchang reading, festival finding
- [NLWeb ask endpoint](https://fatcalendar.com/ask?query=when+is+diwali+2026): natural-language questions, schema.org results
- [AGENTS.md](https://fatcalendar.com/AGENTS.md): how agents should use this site
- [auth.md](https://fatcalendar.com/auth.md): no authentication is required
- [Full documentation in one file](https://fatcalendar.com/llms-full.txt)

## Tools

- [SDK](https://www.npmjs.com/package/@fatcalendar/core): TypeScript SDK `@fatcalendar/core`, `npm install @fatcalendar/core`; usage in [SDK docs](https://fatcalendar.com/docs/sdk)
- [CLI via curl](https://fatcalendar.com/docs/api): no separate CLI; use `curl 'https://fatcalendar.com/api/v1/calendar/day?tradition=telugu&place=Hyderabad'`

## Calendars

- [Gregorian calendar](https://fatcalendar.com/gregorian): Gregorian dates, moon phase, public holidays by country and an optional lunar tithi overlay.
- [Telugu calendar](https://fatcalendar.com/telugu): Amanta lunisolar months, Ugadi new year, samvatsara, tithi and nakshatra with end times, varjyam, durmuhurtham, amrita, Shaka year.
- [Tamil calendar](https://fatcalendar.com/tamil): Solar Tamil months and days, tithi, nakshatra, Nalla Neram, Rahu Kalam, Emagandam and Kuligai.
- [Kannada calendar](https://fatcalendar.com/kannada): Amanta months, Shuddha/Bahula paksha (Padya, Hunnime, Amavasye), samvatsara.
- [Malayalam calendar](https://fatcalendar.com/malayalam): Kollavarsham solar months, naal (nakshatra) prominent, optional nazhika time.
- [Marathi calendar](https://fatcalendar.com/marathi): Amanta months, Shaka era, Sankashti chaturthi, Ekadashi names and Sankranti.
- [Gujarati calendar](https://fatcalendar.com/gujarati): Vikram Samvat starting Kartak Sud 1, Sud/Vad pakshas and the Choghadiya timeline.
- [Punjabi calendar](https://fatcalendar.com/punjabi): Nanakshahi, Desi (Bikrami) and Hindu panchang modes, Sangrand, Gurpurab, Puranmashi and Masya.
- [Bengali calendar](https://fatcalendar.com/bengali): Bangabda solar months, Pohela Boishakh, tithi and festivals such as Durga Puja.
- [North Indian (Hindi) calendar](https://fatcalendar.com/hindi): Purnimanta months, Vikram Samvat, vrata and parana, Bhadra, Panchak.
- [Indian Muslim (Hijri) calendar](https://fatcalendar.com/muslim): Hijri dates (day begins at sunset), five daily prayer times, provisional moon-sighting flag, Ramadan mode.
- [Christian calendar](https://fatcalendar.com/christian): Liturgical season colours, Easter computus, movable feasts, saints and feast days.

## About

- [About fatcalendar](https://fatcalendar.com/about): fatcalendar.com is a free multi-tradition, multi-language, location-aware calendar with daily panchang, festivals and an open API, MCP server and SDK.
- [Methodology and accuracy](https://fatcalendar.com/methodology): How fatcalendar calculates panchang and traditional dates: jotish.ai ephemeris, rule arithmetic, permanent caching, and accuracy caveats including provisional Hijri dates.
- [Frequently asked questions](https://fatcalendar.com/faq): Answers about fatcalendar traditions, languages, data sources, accuracy, privacy, the API and MCP server.
- [Pricing](https://fatcalendar.com/pricing): fatcalendar is free: the website, REST API, MCP server and SDK cost nothing and need no account or API key.
- [Privacy policy](https://fatcalendar.com/privacy): fatcalendar has no accounts, no ads and no tracking cookies. Location is used only to compute your calendar; preferences stay in your browser.
- [Contact fatcalendar](https://fatcalendar.com/contact): How to reach fatcalendar for feedback, corrections to festival dates, API questions or security reports.