Integrate official national, state, and municipal holiday data into your AI Agents and developer tools using the Model Context Protocol (MCP).
The AI recognizes your question's context and automatically calls the correct FeriadosAPI tool without hallucinating dates.
AI developers need accurate real-world context. Our MCP provides instant access to a complete, complex holiday calendar.
Works natively with Claude Desktop, Antigravity, Codex, GitHub Copilot, and any system compatible with the Model Context Protocol.
Empower your AI to answer "is tomorrow a holiday in São Paulo?" or "how many banking business days are left this month?".
No need to build complex holiday tables. Our MCP exposes ready-to-use tools that query and calculate dates directly.
"What are the upcoming long weekend holidays in Rio de Janeiro?"
"Generate a script that shuts down servers on Our Lady of Aparecida day."
"What day of the week is November 20, 2026? Is it a national holiday?"
"List all banking holidays this month so I can adjust billing."
Our server was built strictly following the official MCP specification, ensuring instant compatibility with leading AI tools.
Native integration by configuring the claude_desktop_config.json file
Native integration with Google DeepMind's powerful autonomous agent
Full support for tool use in Codex family models
Connect via SSE or STDIO protocol in your own Python or TS infrastructure
The Model Context Protocol (MCP) acts as a standardized bridge between the LLM's intelligence and FeriadosAPI's official database. Instead of hallucinating dates, the model queries real data.
Register our endpoint in your AI client. No need to code complex HTTP API integrations or write custom routing logic.
The FeriadosAPI server dynamically exposes tools like buscar_feriados and feriados_por_cidade to the LLM securely.
When you ask a question, the LLM autonomously decides which tool to call, passes correct parameters (like year and 7-digit IBGE geographic code), and reads the response.
{
"mcpServers": {
"feriadosapi": {
"command": "npx",
"args": [
"-y",
"@feriados-api/mcp-server"
],
"env": {
"FERIADOS_API_KEY": "fapi_your_key_here"
}
}
}
}Everything you need to know about integrating our Holiday API with Artificial Intelligence.