alanpcf/brasil-data-mcp

> MCP server que expõe dados públicos brasileiros (CNPJ, CEP, bancos, feriados, DDD, ISBN, taxas econômicas, câmbio, corretoras CVM, estados e municípios IBGE, domínios .br) como tools pra Claude Desktop, Claude Code, Cursor, Windsurf e qualquer cliente compatível com Model Context Protocol. Inclui também **prompts MCP** (workflows guiados).
>
> _MCP server exposing Brazilian public data (CNPJ, CEP, banks, holidays, area codes, ISBN, economic rates, exchange rates, CVM brokers, IBGE states/municipalities, .br domains) as tools for Claude Desktop, Claude Code, Cursor, Windsurf and any MCP-compatible client. Ships with MCP prompts for guided workflows._
Powered by BrasilAPI — sem chave, sem auth, dados oficiais.
---
🇧🇷 PT — O que é?
Conecte seu cliente de IA aos dados públicos brasileiros sem escrever uma linha de código. Pergunte em linguagem natural:
- _"Qual a razão social do CNPJ 33.000.167/0001-01?"_
- _"Esse CEP 01310-100 é em qual cidade?"_
- _"Quem é o banco com código 341?"_
- _"Quais os feriados nacionais de 2026?"_
- _"Quais cidades têm DDD 41?"_
- _"Me dá o livro do ISBN 9788532530802."_
- _"Qual a SELIC hoje?"_
- _"A corretora de CNPJ 02.332.886/0011-78 ainda tá ativa?"_
- _"Quanto fechou o dólar sexta-feira?"_
- _"Quais os municípios do Acre?"_
- _"meuprojeto.com.br tá disponível?"_
O Claude (ou outro cliente MCP) chama a tool, retorna o JSON estruturado, e você lê a resposta em português direto na conversa.
Tools disponíveis (15, + 2 com provedor premium)
| Tool | O que faz |
| ---------------------- | ---------------------------------------------------------------------------------- |
| consultar_cnpj | Dados cadastrais de empresa: razão social, situação, endereço, sócios, CNAE |
| consultar_cep | Endereço completo a partir de CEP (logradouro, bairro, cidade, UF, coordenadas) |
| consultar_banco | Nome e ISPB de banco brasileiro pelo código COMPE (ex: 341 = Itaú, 260 = Nubank) |
| listar_bancos | Lista completa de bancos brasileiros cadastrados no BACEN (~250 instituições) |
| consultar_feriados | Feriados nacionais de um ano (datas, nome, tipo) — inclui Carnaval e Páscoa |
| consultar_ddd | Estado e cidades atendidas por um código DDD (ex: 11 = SP capital + região metro) |
| consultar_isbn | Metadados de livro pelo ISBN-10/13 (título, autor, editora, ano, idioma, páginas) |
| consultar_taxa | Valor atual de taxa econômica (SELIC, CDI, IPCA) em % ao ano |
| listar_taxas | Panorama com todas as taxas econômicas vigentes |
| consultar_corretora | Dados cadastrais de corretora de valores autorizada pela CVM (status, endereço) |
| consultar_cambio | Cotação de câmbio (USD, EUR, +8 moedas) em BRL por data — boletins PTAX/BACEN |
| listar_moedas | Moedas estrangeiras com cotação disponível (símbolo, nome, tipo) |
| listar_estados | As 27 UFs com código IBGE, nome, região e capital |
| consultar_municipios | Municípios de uma UF com nome e código IBGE de 7 dígitos |
| consultar_dominio_br | Disponibilidade/status de domínio .br no registro.br (DNS, expiração, sugestões) |
Com o provedor premium opcional habilitado (variável CPFCNPJ_TOKEN, veja a seção abaixo):
| Tool | O que faz |
| ------------------------------ | ---------------------------------------------------------------------------------------- |
| consultar_cpf | Dados cadastrais de pessoa física por CPF na Receita Federal. Requer CPFCNPJ_TOKEN |
| consultar_inscricao_estadual | Inscrições estaduais (IE) de um CNPJ, com filtro opcional por UF. Requer CPFCNPJ_TOKEN |
Prompts disponíveis (2)
Prompts MCP são **workflows guiados** que aparecem como atalho no Claude Desktop. Você seleciona, preenche o argumento e o LLM segue o roteiro pré-definido (chama tools, interpreta, responde).