Brazil Holidays - FeriadosAPI — Claude Code MCP server: what it does
Brazil Holidays - FeriadosAPI pulls Brazilian national, state and city holidays into your agent and checks whether a given date is one. Handy when a task touches the Brazilian calendar.
no license 822 installs updated 2026-03-07
claude mcp add --transport http brazilian-holidays https://brazilian-holidays--feriadosapi.run.toolsWhat Brazil Holidays - FeriadosAPI does
Remote MCP server for the Brazilian calendar. Your agent queries https://brazilian-holidays--feriadosapi.run.tools over HTTP and gets national, state and city holidays back.
Seven tools cover the usual questions. verificar_data takes one date and returns every holiday on it, so a national and a municipal one can show up together. feriados_nacionais lists a year's national dates and can include facultativo days. feriados_por_estado filters by UF, and listar_estados gives you the 27 codes to pick from. buscar_feriados is the general one: date, type, UF, IBGE code, year, month.
Cities need an IBGE code. Call feriados_por_cidade with a city name and it will not resolve. Run buscar_municipios for the UF first, take the code from there, then ask again.
What it helps with
- check whether a date is a holiday before scheduling a call
- get the holiday list for a state from its UF code
- turn a city name into an IBGE code
- pull national holidays for a year, facultativo days included
- filter holidays by month and type in one query
Example prompts for the agent
- Is 25 December a holiday in Brazil? Check with
verificar_data. - List the holidays for the state of RJ.
- Find the IBGE code for São Paulo with
buscar_municipios, then show its city holidays.
How to install Brazil Holidays - FeriadosAPI
Platform CLI: remote server
claude mcp add --transport http brazilian-holidays https://brazilian-holidays--feriadosapi.run.toolsPlatform CLI: remote server
codex mcp add brazil-holidays-feriadosapi --url https://brazilian-holidays--feriadosapi.run.toolsConfig file
{
"mcpServers": {
"brazil-holidays-feriadosapi": {
"url": "https://brazilian-holidays--feriadosapi.run.tools"
}
}
}Config file
{
"servers": {
"brazil-holidays-feriadosapi": {
"type": "http",
"url": "https://brazilian-holidays--feriadosapi.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http brazil-holidays-feriadosapi https://brazilian-holidays--feriadosapi.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Brazil Holidays - FeriadosAPI
How do I install Brazil Holidays - FeriadosAPI in Claude Code?
Run claude mcp add --transport http brazilian-holidays https://brazilian-holidays--feriadosapi.run.tools.
What does Brazil Holidays - FeriadosAPI do?
Gives an agent Brazilian holiday data: national, state and municipal dates, a check for a single day, and lookups by state or city.
Why does feriados_por_cidade return nothing for a city name?
The tool expects the IBGE code, not the name. Get it from buscar_municipios filtered by UF, then pass the code.