# Brazil Holidays - FeriadosAPI

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 822 installs
- Author: feriadosapi
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/feriadosapi/brazilian-holidays
- Updated: 2026-03-07
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/brazil-holidays-feriadosapi

## What it 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.

## Requirements
- Remote server: `https://brazilian-holidays--feriadosapi.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http brazilian-holidays https://brazilian-holidays--feriadosapi.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add brazil-holidays-feriadosapi --url https://brazilian-holidays--feriadosapi.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "brazil-holidays-feriadosapi": {
            "url": "https://brazilian-holidays--feriadosapi.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "brazil-holidays-feriadosapi": {
            "type": "http",
            "url": "https://brazilian-holidays--feriadosapi.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http brazil-holidays-feriadosapi https://brazilian-holidays--feriadosapi.run.tools
```

## When to use it
- 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
- 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.

## Similar
- [Dorabot – Vietnam public holidays & business days](https://affpapa.org/en/nevibecode/mcp/dorabot-vietnam-public-holidays-business-days.md) — MCP server
- [japan-holiday-mcp](https://affpapa.org/en/nevibecode/mcp/japan-holiday-mcp.md) — MCP server · 337 installs
- [Brazil CNPJ company registry](https://affpapa.org/en/nevibecode/mcp/brazil-cnpj-company-registry.md) — MCP server · ★ 6 repo stars
- [Kyrodata — Brazil Trade, Crop & Commodity Data](https://affpapa.org/en/nevibecode/mcp/kyrodata-brazil-trade-crop-commodity-data.md) — MCP server · ★ 1 repo stars
- [PlugRail Japanese Calendar](https://affpapa.org/en/nevibecode/mcp/plugrail-japanese-calendar.md) — MCP server
- [mcp-brasil-server](https://affpapa.org/en/nevibecode/skills/mcp-brasil-server.md) — skill · 225 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
