README.md
Consult Brazilian holidays directly in your favorite AI agent
🇧🇷 Feriados API — MCP Server
Consulte feriados brasileiros (nacionais, estaduais e municipais) direto no seu agente de IA favorito usando o Model Context Protocol.
⚡ Quick Start
Opção 1: URL Remota (recomendado)
Adicione ao seu cliente de IA:
https://mcp.feriadosapi.com/api/mcp
Com sua própria API key (BYOK):
https://mcp.feriadosapi.com/api/mcp?apiKey=fapi_sua_chave_aqui
💡 Crie uma conta gratuita em feriadosapi.com para obter sua API key — acesso ilimitado a feriados nacionais, estaduais e capitais (60 req/min).
Opção 2: Via npx (local)
Obtenha uma API key gratuita em feriadosapi.com e configure:
{
"mcpServers": {
"feriadosapi": {
"command": "npx",
"args": ["-y", "@feriados-api/mcp-server"],
"env": {
"FERIADOS_API_KEY": "fapi_sua_chave_aqui"
}
}
}
}
🛠️ Tools Disponíveis
| Tool | Descrição |
|---|---|
buscar_feriados |
Busca com filtros flexíveis (data, tipo, UF, IBGE, ano, mês) |
feriados_nacionais |
Feriados nacionais do Brasil |
feriados_por_estado |
Feriados por estado (UF) |
feriados_por_cidade |
Feriados por cidade (código IBGE) |
verificar_data |
Verifica se uma data é feriado |
listar_estados |
Lista estados brasileiros |
buscar_municipios |
Busca municípios por UF |
🔧 Configuração por Cliente
Claude Desktop / Claude Code
{
"mcpServers": {
"feriadosapi": {
"command": "npx",
"args": ["-y", "@feriados-api/mcp-server"],
"env": {
"FERIADOS_API_KEY": "fapi_sua_chave_aqui"
}
}
}
}
Cursor
// .cursor/mcp.json
{
"mcpServers": {
"feriadosapi": {
"command": "npx",
"args": ["-y", "@feriados-api/mcp-server"],
"env": {
"FERIADOS_API_KEY": "fapi_sua_chave_aqui"
}
}
}
}
GitHub Copilot
// Configuração do GitHub Copilot MCP
{
"github.copilot.mcp.servers": {
"feriadosapi": {
"command": "npx",
"args": ["-y", "@feriados-api/mcp-server"],
"env": {
"FERIADOS_API_KEY": "fapi_sua_chave_aqui"
}
}
}
}
Windsurf
// ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"feriadosapi": {
"command": "npx",
"args": ["-y", "@feriados-api/mcp-server"],
"env": {
"FERIADOS_API_KEY": "fapi_sua_chave_aqui"
}
}
}
}
Antigravity (Gemini Code Assist)
// .gemini/settings.json
{
"mcpServers": {
"feriadosapi": {
"command": "npx",
"args": ["-y", "@feriados-api/mcp-server"],
"env": {
"FERIADOS_API_KEY": "fapi_sua_chave_aqui"
}
}
}
}
Gemini CLI
// ~/.gemini/settings.json
{
"mcpServers": {
"feriadosapi": {
"command": "npx",
"args": ["-y", "@feriados-api/mcp-server"],
"env": {
"FERIADOS_API_KEY": "fapi_sua_chave_aqui"
}
}
}
}
OpenAI Codex CLI
// ~/.codex/config.json
{
"mcpServers": {
"feriadosapi": {
"command": "npx",
"args": ["-y", "@feriados-api/mcp-server"],
"env": {
"FERIADOS_API_KEY": "fapi_sua_chave_aqui"
}
}
}
}
ChatGPT / OpenAI Agents
URL: https://mcp.feriadosapi.com/api/mcp?apiKey=SUA_API_KEY
💬 Exemplos de uso
Após configurar, pergunte ao seu agente:
- "Quais são os feriados de São Paulo em 2026?"
- "Amanhã é feriado?"
- "Quando é o Carnaval?"
- "Quais feriados caem na sexta-feira em 2026?"
- "Qual o código IBGE de Curitiba?"
🔑 Autenticação
Uma API key é obrigatória. Crie uma conta gratuita em feriadosapi.com (acesso ilimitado, 60 req/min) e passe sua chave:
- Via URL remota:
?apiKey=fapi_xxxna URL do MCP - Via stdio (local): env var `FERIADOS
Tools (7)
buscar_feriadosSearch with flexible filters including date, type, UF, IBGE code, year, and month.feriados_nacionaisGet national holidays in Brazil.feriados_por_estadoGet holidays by state (UF).feriados_por_cidadeGet holidays by city using IBGE code.verificar_dataCheck if a specific date is a holiday.listar_estadosList Brazilian states.buscar_municipiosSearch for municipalities by state (UF).Environment Variables
FERIADOS_API_KEYrequiredAPI key obtained from feriadosapi.comConfiguration
claude_desktop_config.json
{"mcpServers": {"feriadosapi": {"command": "npx", "args": ["-y", "@feriados-api/mcp-server"], "env": {"FERIADOS_API_KEY": "fapi_sua_chave_aqui"}}}}Try it
→What are the holidays in São Paulo in 2026?
→Is tomorrow a holiday?
→When is Carnival?
→Which holidays fall on a Friday in 2026?
→What is the IBGE code for Curitiba?