@feriados-dev/mcp-server

Servidor MCP do feriados.dev para consultar feriados nacionais, estaduais e municipais do Brasil a partir de clientes como Claude Desktop, Cursor e outros agentes compatíveis com o Model Context Protocol.

Uso

Configure uma API key do feriados.dev no cliente MCP:

{
  "mcpServers": {
    "feriados-dev": {
      "command": "npx",
      "args": ["-y", "@feriados-dev/mcp-server"],
      "env": {
        "FERIADOS_API_KEY": "frd_SUA_CHAVE"
      }
    }
  }
}

Para apontar para outro ambiente:

{
  "mcpServers": {
    "feriados-dev": {
      "command": "npx",
      "args": ["-y", "@feriados-dev/mcp-server"],
      "env": {
        "FERIADOS_API_KEY": "frd_SUA_CHAVE",
        "FERIADOS_API_URL": "https://api.feriados.dev"
      }
    }
  }
}

Ferramentas

• buscar_feriados: busca feriados por ano, localidade e tipo.
• proximos_feriados: lista os próximos feriados aplicáveis.
• verificar_feriado: verifica se uma data é feriado.
• verificar_dia_util: verifica se uma data é dia útil.
• proximo_dia_util: retorna o próximo dia útil.
• adicionar_dias_uteis: soma ou subtrai dias úteis.
• comparar_feriados: compara feriados entre localidades.
• buscar_localidades: encontra códigos de estados e municípios por nome.

Desenvolvimento

npm install
FERIADOS_API_KEY=frd_SUA_CHAVE npm run dev

Exemplos

• "Amanhã é feriado em Campinas?"
• "Qual é o próximo dia útil em São Paulo depois de 2026-02-16?"
• "Compare os feriados de Recife e Salvador em 2026."
• "Some 10 dias úteis a partir de 2026-06-01 em Belo Horizonte."