FestivalFinder
Computed Hindu festival dates: Diwali, Holi, Navratri, more.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"festival-finder": {
"url": "https://festival-finder.magicteams.ai/mcp"
}
}
}Remote endpoints
https://festival-finder.magicteams.ai/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢list_festivals(year)
Compute all major Hindu festivals (Ugadi, Holi, Diwali, Navratri, Ganesh Chaturthi, etc.) and the 12 solar sankrantis for one year, 2020-2040, sorted by date. Dates are approximate (+/-1 day). Use for a full-year overview. Do NOT use for one month (use festivals_in_month) or the next upcoming one (use next_festival).
Input Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 2020,
"maximum": 2040,
"description": "Gregorian year, 2020-2040, e.g. 2026"
}
},
"required": [
"year"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"description": "The year that was computed."
},
"festivals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Festival name, e.g. \"Diwali / Lakshmi Puja\" or \"Makara Sankranti / Pongal\"."
},
"date": {
"type": "string",
"description": "Computed Gregorian date, YYYY-MM-DD (approximate, +/-1 day at tithi edges)."
},
"about": {
"type": "string",
"description": "Short meaning and the lunar or solar rule that fixes the date."
},
"tithi": {
"type": "string",
"description": "Lunar day index at IST noon on that date, 0-29 (0 = Shukla Pratipada, 29 = Amavasya), as 'index N'."
},
"month": {
"type": "string",
"description": "Amanta lunar month name in effect on that date, e.g. Ashwin."
}
},
"required": [
"name",
"date",
"about",
"tithi",
"month"
]
},
"description": "Festivals and sankrantis in that year, sorted by date."
}
},
"required": [
"year",
"festivals"
]
}🟢next_festival(from_date)
Find the first Hindu festival or sankranti falling on or after a given date (looks into the following year if needed; 2020-2040 only). Use for 'what is the next festival?' questions. Do NOT use for a list; use list_festivals or festivals_in_month.
Input Schema
{
"type": "object",
"properties": {
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date YYYY-MM-DD (inclusive), year 2020-2040, e.g. 2026-10-10. Use today's date for 'next'."
}
},
"required": [
"from_date"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Festival name, e.g. \"Diwali / Lakshmi Puja\" or \"Makara Sankranti / Pongal\"."
},
"date": {
"type": "string",
"description": "Computed Gregorian date, YYYY-MM-DD (approximate, +/-1 day at tithi edges)."
},
"about": {
"type": "string",
"description": "Short meaning and the lunar or solar rule that fixes the date."
},
"tithi": {
"type": "string",
"description": "Lunar day index at IST noon on that date, 0-29 (0 = Shukla Pratipada, 29 = Amavasya), as 'index N'."
},
"month": {
"type": "string",
"description": "Amanta lunar month name in effect on that date, e.g. Ashwin."
}
},
"required": [
"name",
"date",
"about",
"tithi",
"month"
]
}🟢festival_details(name, year)
Look up one festival by name in a given year and return its computed date, lunar month, tithi and the rule behind it. Name matching is case-insensitive and partial (e.g. 'diwali', 'holi', 'makara'); first match wins. Use when the user asks when a specific festival is. Do NOT use to list several; use list_festivals.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Festival name or part of it, case-insensitive, e.g. \"Diwali\", \"Holi\", \"Maha Shivaratri\", \"Onam\", \"Makara Sankranti\"."
},
"year": {
"type": "integer",
"minimum": 2020,
"maximum": 2040,
"description": "Gregorian year, 2020-2040, e.g. 2026"
}
},
"required": [
"name",
"year"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Festival name, e.g. \"Diwali / Lakshmi Puja\" or \"Makara Sankranti / Pongal\"."
},
"date": {
"type": "string",
"description": "Computed Gregorian date, YYYY-MM-DD (approximate, +/-1 day at tithi edges)."
},
"about": {
"type": "string",
"description": "Short meaning and the lunar or solar rule that fixes the date."
},
"tithi": {
"type": "string",
"description": "Lunar day index at IST noon on that date, 0-29 (0 = Shukla Pratipada, 29 = Amavasya), as 'index N'."
},
"month": {
"type": "string",
"description": "Amanta lunar month name in effect on that date, e.g. Ashwin."
}
},
"required": [
"name",
"date",
"about",
"tithi",
"month"
]
}🟢festivals_in_month(year, month)
List the Hindu festivals and sankrantis that fall in one calendar month of a year (2020-2040), sorted by date; may be empty. Use for questions like 'festivals in October 2026'. Do NOT use for the whole year (use list_festivals) or the next one (use next_festival).
Input Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 2020,
"maximum": 2040,
"description": "Gregorian year, 2020-2040, e.g. 2026"
},
"month": {
"type": "integer",
"minimum": 1,
"maximum": 12,
"description": "Calendar month 1-12 (1 = January, 12 = December)"
}
},
"required": [
"year",
"month"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"description": "The year that was searched."
},
"month": {
"type": "integer",
"description": "The calendar month that was searched, 1-12."
},
"festivals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Festival name, e.g. \"Diwali / Lakshmi Puja\" or \"Makara Sankranti / Pongal\"."
},
"date": {
"type": "string",
"description": "Computed Gregorian date, YYYY-MM-DD (approximate, +/-1 day at tithi edges)."
},
"about": {
"type": "string",
"description": "Short meaning and the lunar or solar rule that fixes the date."
},
"tithi": {
"type": "string",
"description": "Lunar day index at IST noon on that date, 0-29 (0 = Shukla Pratipada, 29 = Amavasya), as 'index N'."
},
"month": {
"type": "string",
"description": "Amanta lunar month name in effect on that date, e.g. Ashwin."
}
},
"required": [
"name",
"date",
"about",
"tithi",
"month"
]
},
"description": "Festivals in that month, sorted by date (may be empty)."
}
},
"required": [
"year",
"month",
"festivals"
]
}Community
Evidence