FestivalFinder MCP

FestivalFinder provides MCP tools for AI assistants to compute Hindu festival dates, tithi rules, and monthly calendars for the years 2020-2040. It supports querying specific festivals, listing events by month or year, and finding the next upcoming festival based on lunar calculations.

Visit MagicTeams

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Community listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by MagicTeams

MCP endpoint (Streamable HTTP)

https://festival-finder.magicteams.ai/mcp

Vendor documentation

What its tools do

4 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

4 of 4 have a description · 4 of 4 declare behavior hints · 4 of 4 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

Passed Endpoint answered the live check · Nov 6, 2026, 3:55 PM UTC
Availability 1 of 1 checks passed in 30 days

What you can do with it

Compute all major Hindu festivals and solar sankrantis for a specific year
Find the first Hindu festival or sankranti falling on or after a given date
Look up a specific festival's date, lunar month, and tithi rule
List Hindu festivals and sankrantis that fall in one calendar month

Source and maintenance

Community listingRegistry 1.0.0

mcp-registry: io.github.everyai-com/festival-finder@1.0.0 Source repository

Maintenance checked: Nov 6, 2026, 3:51 PM UTC

Protocol and capabilities

Server: festival-finder 1.0.0
MCP protocol negotiated in check: 2025-11-25
Tools: 4 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

FestivalFinder computes Hindu festival dates 2020-2040. Approximate within a day; advise verifying muhurta-critical dates.

Tools

4 advertised

list_festivals — List festivals

Advertised by the server during the last successful anonymous check.

Advertised read-only

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

list_festivals input schema

{
  "type": "object",
  "required": [
    "year"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2040,
      "minimum": 2020,
      "description": "Gregorian year, 2020-2040, e.g. 2026"
    }
  },
  "additionalProperties": false
}

list_festivals output schema

{
  "type": "object",
  "required": [
    "year",
    "festivals"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "The year that was computed."
    },
    "festivals": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "date",
          "about",
          "tithi",
          "month"
        ],
        "properties": {
          "date": {
            "type": "string",
            "description": "Computed Gregorian date, YYYY-MM-DD (approximate, +/-1 day at tithi edges)."
          },
          "name": {
            "type": "string",
            "description": "Festival name, e.g. \"Diwali / Lakshmi Puja\" or \"Makara Sankranti / Pongal\"."
          },
          "about": {
            "type": "string",
            "description": "Short meaning and the lunar or solar rule that fixes the date."
          },
          "month": {
            "type": "string",
            "description": "Amanta lunar month name in effect on that date, e.g. Ashwin."
          },
          "tithi": {
            "type": "string",
            "description": "Lunar day index at IST noon on that date, 0-29 (0 = Shukla Pratipada, 29 = Amavasya), as 'index N'."
          }
        }
      },
      "description": "Festivals and sankrantis in that year, sorted by date."
    }
  }
}

list_festivals annotations

{
  "title": "List festivals",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

next_festival — Next festival

Advertised by the server during the last successful anonymous check.

Advertised read-only

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.

next_festival input schema

{
  "type": "object",
  "required": [
    "from_date"
  ],
  "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'."
    }
  },
  "additionalProperties": false
}

next_festival output schema

{
  "type": "object",
  "required": [
    "name",
    "date",
    "about",
    "tithi",
    "month"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Computed Gregorian date, YYYY-MM-DD (approximate, +/-1 day at tithi edges)."
    },
    "name": {
      "type": "string",
      "description": "Festival name, e.g. \"Diwali / Lakshmi Puja\" or \"Makara Sankranti / Pongal\"."
    },
    "about": {
      "type": "string",
      "description": "Short meaning and the lunar or solar rule that fixes the date."
    },
    "month": {
      "type": "string",
      "description": "Amanta lunar month name in effect on that date, e.g. Ashwin."
    },
    "tithi": {
      "type": "string",
      "description": "Lunar day index at IST noon on that date, 0-29 (0 = Shukla Pratipada, 29 = Amavasya), as 'index N'."
    }
  }
}

next_festival annotations

{
  "title": "Next festival",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

festival_details — Festival details

Advertised by the server during the last successful anonymous check.

Advertised read-only

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.

festival_details input schema

{
  "type": "object",
  "required": [
    "name",
    "year"
  ],
  "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",
      "maximum": 2040,
      "minimum": 2020,
      "description": "Gregorian year, 2020-2040, e.g. 2026"
    }
  },
  "additionalProperties": false
}

festival_details output schema

{
  "type": "object",
  "required": [
    "name",
    "date",
    "about",
    "tithi",
    "month"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Computed Gregorian date, YYYY-MM-DD (approximate, +/-1 day at tithi edges)."
    },
    "name": {
      "type": "string",
      "description": "Festival name, e.g. \"Diwali / Lakshmi Puja\" or \"Makara Sankranti / Pongal\"."
    },
    "about": {
      "type": "string",
      "description": "Short meaning and the lunar or solar rule that fixes the date."
    },
    "month": {
      "type": "string",
      "description": "Amanta lunar month name in effect on that date, e.g. Ashwin."
    },
    "tithi": {
      "type": "string",
      "description": "Lunar day index at IST noon on that date, 0-29 (0 = Shukla Pratipada, 29 = Amavasya), as 'index N'."
    }
  }
}

festival_details annotations

{
  "title": "Festival details",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

festivals_in_month — Festivals in month

Advertised by the server during the last successful anonymous check.

Advertised read-only

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

festivals_in_month input schema

{
  "type": "object",
  "required": [
    "year",
    "month"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2040,
      "minimum": 2020,
      "description": "Gregorian year, 2020-2040, e.g. 2026"
    },
    "month": {
      "type": "integer",
      "maximum": 12,
      "minimum": 1,
      "description": "Calendar month 1-12 (1 = January, 12 = December)"
    }
  },
  "additionalProperties": false
}

festivals_in_month output schema

{
  "type": "object",
  "required": [
    "year",
    "month",
    "festivals"
  ],
  "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",
        "required": [
          "name",
          "date",
          "about",
          "tithi",
          "month"
        ],
        "properties": {
          "date": {
            "type": "string",
            "description": "Computed Gregorian date, YYYY-MM-DD (approximate, +/-1 day at tithi edges)."
          },
          "name": {
            "type": "string",
            "description": "Festival name, e.g. \"Diwali / Lakshmi Puja\" or \"Makara Sankranti / Pongal\"."
          },
          "about": {
            "type": "string",
            "description": "Short meaning and the lunar or solar rule that fixes the date."
          },
          "month": {
            "type": "string",
            "description": "Amanta lunar month name in effect on that date, e.g. Ashwin."
          },
          "tithi": {
            "type": "string",
            "description": "Lunar day index at IST noon on that date, 0-29 (0 = Shukla Pratipada, 29 = Amavasya), as 'index N'."
          }
        }
      },
      "description": "Festivals in that month, sorted by date (may be empty)."
    }
  }
}

festivals_in_month annotations

{
  "title": "Festivals in month",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (2 of 2 answered).

2026-11-06: 1 of 1 checks answered
2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 224 ms
95th percentile latency: 224 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 6, 2026, 3:55 PM UTC · probe · passed · 224 ms · metadata changed · 4 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http festivalfinder-mcp https://festival-finder.magicteams.ai/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add festivalfinder-mcp --url https://festival-finder.magicteams.ai/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable festivalfinder-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "festivalfinder-mcp": {
      "url": "https://festival-finder.magicteams.ai/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "festivalfinder-mcp": {
      "type": "streamableHttp",
      "url": "https://festival-finder.magicteams.ai/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start festivalfinder-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "festivalfinder-mcp": {
      "type": "http",
      "url": "https://festival-finder.magicteams.ai/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http festivalfinder-mcp https://festival-finder.magicteams.ai/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.

Claude Desktop configuration

https://festival-finder.magicteams.ai/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "festivalfinder-mcp": {
      "serverUrl": "https://festival-finder.magicteams.ai/mcp"
    }
  }
}

Let your agent find its tools

Find servers like FestivalFinder MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 5,895

FestivalFinder MCP

Endpoint and access

What its tools do

Read-only (4)

Checks and signals

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

90-day uptime

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other productivity and knowledge servers