# Brazil Holidays - FeriadosAPI

Real-time MCP server to fetch Brazilian national, state, and municipal holidays. Easily check if a specific date is a holiday, search by location, and seamlessly integrate accurate Brazilian calendar…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add feriadosapi/brazilian-holidays

# Browse available tools
npx -y @smithery/cli@latest tool list feriadosapi/brazilian-holidays

# Get full schema for a tool
npx -y @smithery/cli@latest tool get feriadosapi/brazilian-holidays buscar_feriados

# Call a tool
npx -y @smithery/cli@latest tool call feriadosapi/brazilian-holidays buscar_feriados '{}'
```

## Direct MCP Connection

Endpoint: `https://brazilian-holidays--feriadosapi.run.tools`

**Required config:**
- `FERIADOS_API_KEY` (query) — feriadosapi.com api key

## Tools (7)

- `buscar_feriados` — Busca feriados brasileiros com filtros flexíveis.
- `feriados_nacionais` — Lista todos os feriados nacionais do Brasil para um ano específico.
- `feriados_por_estado` — Lista todos os feriados de um estado brasileiro (feriados nacionais + estaduais daquele UF).
- `feriados_por_cidade` — Lista todos os feriados de uma cidade brasileira (feriados nacionais + estaduais + municipais).
- `verificar_data` — Verifica se uma data específica é feriado no Brasil.
- `listar_estados` — Lista todos os 27 estados brasileiros (26 estados + Distrito Federal) com suas siglas UF.
- `buscar_municipios` — Busca municípios brasileiros por estado. Retorna nome, UF e código IBGE de cada município.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get feriadosapi/brazilian-holidays <tool-name>
```