fatcalendar documentation
Developer and agent documentation for the fatcalendar REST API, MCP server, SDK and agent protocols.
Choose an interface
| Interface | Use it when | Entry point |
|---|---|---|
| REST API | Scripts, apps, backends | https://fatcalendar.com/api/v1 and openapi.json |
| MCP server | Claude, Cursor, ChatGPT and other AI assistants | https://fatcalendar.com/mcp |
| SDK | TypeScript / React Native | @fatcalendar/core |
| Agent guide | Autonomous agents and crawlers | AGENTS.md, llms.txt |
All interfaces are free, need no API key and return the same data.
Quick start
curl 'https://fatcalendar.com/api/v1/calendar/day?tradition=telugu&lang=en&place=Hyderabad&date=2026-11-08'
Concepts
- tradition selects the calendar system (gregorian, telugu, tamil, kannada, malayalam, marathi, gujarati, punjabi, bengali, hindi, muslim, christian). lang selects the display language (en, te, ta, kn, ml, mr, gu, pa, bn, hi, ur). They are independent.
- variant optionally selects a sub-variant of the tradition.
- Location is
lat+lon+tz, orplacefree text, or inferred from the request. - Dates are civil dates
YYYY-MM-DDin the location's time zone.
Machine-readable index
- OpenAPI 3.1: /openapi.json (YAML: /openapi.yaml)
- API catalog (RFC 9727): /.well-known/api-catalog
- MCP server card: /.well-known/mcp/server-card.json
- A2A agent card: /.well-known/agent-card.json
- Agent skills: /.well-known/agent-skills/index.json
- AI catalog: /.well-known/ai-catalog.json
- NLWeb: /ask