Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http brazilian-holidays https://brazilian-holidays--feriadosapi.run.tools
Open on GitHub

What 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.tools

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

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open