_ registry / mcp http-sse · checked 4h ago

feriadosapi

https://mcp.feriadosapi.com

Registry code: 6c11a14ebb24d338

api record

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 data into your AI agents and workflows.

from a public catalogue that lists it, not from the operator

endpoint
https://mcp.feriadosapi.com/api/mcp
protocol
http-sse ·2025-06-18
authentication
bearer
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is feriadosapi live?
Yes — it answered the hub's last check (checked 4h ago). It answered 99% of checks over the last 30 days.
Is feriadosapi free to use?
Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.
What tools does feriadosapi have?
9 tools: buscar_municipios, buscar_feriados, feriados_bancarios, feriados_nacionais, feriados_por_estado, feriados_por_cidade, verificar_data, verificar_dia_util_bancario, ….
Is feriadosapi safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
98.5%

90 days 99.1%· all time 99.1%

latency
295ms

last good check

priced tools
0

of 9 tools

_ answered our checks, 90 days 232 checks · signed record
  • degraded → live
  • live → degraded· timeout after 20000ms
  • degraded → live
  • unknown → live
_ what it is for
used for
  • check if a date is a brazilian holiday
  • list holidays for a brazilian city
  • check bank business days in brazil
takes → gives
text → data
tools
9 reads
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 9 tools
9 never probed 0 of 9 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • buscar_municipios reads unknown never probed

    Busca municípios brasileiros por estado. Retorna nome, UF e código IBGE de cada município. Use esta tool para descobrir o código IBGE de uma cidade antes de consultar feriados municipais com 'feriados_por_cidade'. Pode filtrar por UF para listar apenas municípios de um estado. O Brasil possui mais de 5.500 municípios; use o filtro de UF para resultados mais precisos.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "uf": {
          "type": "string",
          "maxLength": 2,
          "minLength": 2,
          "description": "Sigla do estado para filtrar (ex: SP, RJ). Se omitido, retorna todos os municípios paginados."
        },
        "page": {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 1,
          "description": "Número da página (default: 1)"
        },
        "limit": {
          "type": "integer",
          "maximum": 100,
          "minimum": 1,
          "description": "Itens por página (default: 50, max: 100)"
        }
      }
    }
    arguments 24 lines
  • buscar_feriados reads unknown never probed

    Busca feriados brasileiros com filtros flexíveis. Use esta tool para consultas gerais quando precisar filtrar por múltiplos critérios ao mesmo tempo. Pode filtrar por data, tipo (NACIONAL/ESTADUAL/MUNICIPAL/FACULTATIVO), estado (UF), cidade (código IBGE), ano e mês. Para buscas mais específicas, prefira usar as tools especializadas (feriados_nacionais, feriados_por_estado, etc.). Retorna lista paginada de feriados com nome, data (DD/MM/YYYY), tipo, descrição e indicador bancário (FEBRABAN).

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "uf": {
          "type": "string",
          "maxLength": 2,
          "minLength": 2,
          "description": "Sigla do estado em maiúsculas (ex: SP, RJ, MG)"
        },
        "ano": {
          "type": "string",
          "description": "Ano com 4 dígitos (ex: 2026)"
        },
        "date": {
          "type": "string",
          "description": "Data no formato YYYY-MM-DD (ex: 2026-12-25)"
        },
        "ibge": {
          "type": "string",
          "description": "Código IBGE do município (ex: 3550308 para São Paulo)"
        },
        "type": {
          "enum": [
            "NACIONAL",
            "ESTADUAL",
            "MUNICIPAL",
            "FACULTATIVO"
          ],
          "type": "string",
          "description": "Tipo do feriado"
        },
        "month": {
          "type": "string",
          "description": "Mês de 1 a 12 (requer que 'ano' também seja informado)"
        },
        "bancarios": {
          "type": "boolean",
          "description": "Se true, retorna apenas feriados bancários (calendário FEBRABAN)"
        }
      }
    }
    arguments 42 lines
  • feriados_bancarios reads unknown never probed

    Lista todos os feriados bancários do calendário oficial FEBRABAN (Resolução 4.880/2020 do CMN). Inclui feriados nacionais + datas facultativas em que agências bancárias não funcionam: Carnaval (seg/ter), Quarta-feira de Cinzas, Corpus Christi e Véspera de Ano Novo (31/dez). Ideal para cálculos de vencimentos, compensações e prazos bancários. Pode filtrar por estado (UF) ou município (IBGE) para incluir feriados bancários estaduais/municipais.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "uf": {
          "type": "string",
          "maxLength": 2,
          "minLength": 2,
          "description": "Sigla do estado para incluir feriados estaduais bancários (ex: SP)"
        },
        "ano": {
          "type": "string",
          "description": "Ano com 4 dígitos (ex: 2026)"
        },
        "ibge": {
          "type": "string",
          "description": "Código IBGE do município para incluir feriados municipais bancários"
        },
        "facultativos": {
          "type": "boolean",
          "description": "Se true, inclui feriados facultativos bancários"
        }
      }
    }
    arguments 24 lines
  • feriados_nacionais reads unknown never probed

    Lista todos os feriados nacionais do Brasil para um ano específico. Inclui feriados como Carnaval, Sexta-feira Santa, Tiradentes, Dia do Trabalho, Independência, Nossa Senhora Aparecida, Finados, Proclamação da República e Natal. Opcionalmente pode incluir feriados facultativos nacionais (Ponto Facultativo). Se nenhum ano for informado, retorna feriados de todos os anos disponíveis.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "ano": {
          "type": "string",
          "description": "Ano com 4 dígitos (ex: 2026). Se omitido, retorna todos os anos."
        },
        "bancarios": {
          "type": "boolean",
          "description": "Se true, retorna apenas feriados bancários (calendário FEBRABAN)"
        },
        "facultativos": {
          "type": "boolean",
          "description": "Se true, inclui feriados facultativos nacionais (ex: Carnaval, Corpus Christi)"
        }
      }
    }
    arguments 18 lines
  • feriados_por_estado reads unknown never probed

    Lista todos os feriados de um estado brasileiro (feriados nacionais + estaduais daquele UF). Use quando o usuário perguntar sobre feriados em um estado específico, como "feriados em São Paulo" ou "feriados do RJ". As siglas dos estados (UF) são: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "uf"
      ],
      "properties": {
        "uf": {
          "type": "string",
          "maxLength": 2,
          "minLength": 2,
          "description": "Sigla do estado em maiúsculas (ex: SP, RJ, MG, BA)"
        },
        "ano": {
          "type": "string",
          "description": "Ano com 4 dígitos (ex: 2026)"
        },
        "bancarios": {
          "type": "boolean",
          "description": "Se true, retorna apenas feriados bancários (calendário FEBRABAN)"
        },
        "facultativos": {
          "type": "boolean",
          "description": "Se true, inclui feriados facultativos do estado"
        }
      }
    }
    arguments 27 lines
  • feriados_por_cidade reads unknown never probed

    Lista todos os feriados de uma cidade brasileira (feriados nacionais + estaduais + municipais). Use quando o usuário perguntar sobre feriados em uma cidade específica. Requer o código IBGE do município. Se não souber o código IBGE, use primeiro a tool 'buscar_municipios' para encontrá-lo. Exemplos de códigos IBGE: São Paulo = 3550308, Rio de Janeiro = 3304557, Belo Horizonte = 3106200, Brasília = 5300108.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "ibge"
      ],
      "properties": {
        "ano": {
          "type": "string",
          "description": "Ano com 4 dígitos (ex: 2026)"
        },
        "ibge": {
          "type": "string",
          "description": "Código IBGE do município (ex: 3550308 para São Paulo). Use 'buscar_municipios' se não souber o código."
        },
        "bancarios": {
          "type": "boolean",
          "description": "Se true, retorna apenas feriados bancários (calendário FEBRABAN)"
        },
        "facultativos": {
          "type": "boolean",
          "description": "Se true, inclui feriados facultativos"
        }
      }
    }
    arguments 25 lines
  • verificar_data reads unknown never probed

    Verifica se uma data específica é feriado no Brasil. Use quando o usuário perguntar algo como "amanhã é feriado?", "25 de dezembro é feriado?", ou "segunda-feira vai ser feriado?". Retorna todos os feriados que caem naquela data (pode ter mais de um: nacional + municipal, por exemplo). Se retornar lista vazia, a data NÃO é feriado.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "data"
      ],
      "properties": {
        "data": {
          "type": "string",
          "description": "Data no formato YYYY-MM-DD (ex: 2026-12-25)"
        }
      }
    }
    arguments 13 lines
  • verificar_dia_util_bancario reads unknown never probed

    Verifica se uma data é dia útil bancário (agências abrem normalmente). Use quando o usuário perguntar "o banco abre amanhã?", "quando vence o boleto?", "qual o próximo dia útil bancário?". Se não for dia útil, retorna o motivo (feriado bancário ou fim de semana) e o próximo dia útil bancário. Considera o calendário oficial FEBRABAN incluindo Carnaval, Quarta de Cinzas, Corpus Christi e 31/dez.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "data"
      ],
      "properties": {
        "data": {
          "type": "string",
          "description": "Data no formato YYYY-MM-DD (ex: 2026-02-16)"
        }
      }
    }
    arguments 13 lines
  • listar_estados reads unknown never probed

    Lista todos os 27 estados brasileiros (26 estados + Distrito Federal) com suas siglas UF. Use quando precisar consultar as siglas dos estados ou quando o usuário perguntar "quais são os estados do Brasil". Retorna sigla (UF) e nome completo de cada estado.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {}
    }
    arguments 5 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 6c11a14ebb24d338.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/6c11a14ebb24d338/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/6c11a14ebb24d338/badge.svg)](https://brick.blue/agent/6c11a14ebb24d338?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.