Mcp Brasil

io.github.viniciusmdoobmv0.2.0Updated Oct 8, 2026

Dados brasileiros para agentes de IA: CEP, CNPJ, bancos, taxas, feriados, clima e FIPE.

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant look up Brazilian public data: postal codes, company records, banks, rates, holidays, weather and FIPE vehicle prices.

What it does
Exposes eight lookup tools backed by public Brazilian APIs. lookup_cep returns a full address from a postal code, buscar_cep finds a postal code from street, city and state, lookup_cnpj returns company name, registration status, CNAE and share capital, and lookup_banco maps a bank code to its name. It also provides current SELIC, CDI and IPCA rates, national holidays for any year, current temperature for any city, and FIPE vehicle brands, models and prices.
When to use it
Useful when an assistant needs Brazilian address, company, banking, economic indicator, holiday, weather or vehicle price data in a single call instead of scraping sites with captchas and ads. Best for Brazilian-context tasks such as validating a supplier's CNPJ, filling in an address from a postal code, or checking a holiday date.
Requirements
Runs as a remote HTTP endpoint, or locally with Node.js 18+ via node index.js (stdio) or node web.js (HTTP). The README shows a bearer token in the Authorization header for the hosted endpoint and an API_KEY_MCP variable for the local web mode; PORT sets the local port. No account or signup is described.
Before you install
The README publishes a bearer token for the hosted endpoint in plain text, so treat it as shared and not private. In local web mode, if API_KEY_MCP is unset the server runs without authentication, which the README says is only for local testing. Queries are sent to third-party public APIs (ViaCEP, BrasilAPI, Open-Meteo). All tools are read-only lookups.

Installation

In SourceWeft

  1. Open Mcp Brasil in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mcp-brasil": {
      "type": "http",
      "url": "https://mcp-brasil-fvll.onrender.com/mcp"
    }
  }
}

README

mcp-brasil

CEP, CNPJ e mais 6 consultas brasileiras, direto no seu agente de IA. Sem site, sem anúncio, sem captcha.

Ferramentas de dados brasileiros para agentes de IA, via Model Context Protocol (MCP). O que o brasileiro consulta toda semana — endereço, empresa, banco, taxas, feriados, clima, preço de carro — disponível como ferramenta que Claude, ChatGPT, OpenClaude e qualquer cliente MCP podem chamar diretamente.

Ferramentas

FerramentaO que fazFonte
lookup_cepEndereço completo a partir do CEPViaCEP
buscar_cepEncontra o CEP pelo nome da rua + cidade + UFViaCEP
lookup_cnpjRazão social, situação cadastral, CNAE, capital socialBrasilAPI
lookup_bancoNome do banco pelo código (260 → Nubank)BrasilAPI
taxasSELIC, CDI e IPCA atuaisBrasilAPI
feriadosFeriados nacionais de qualquer anoBrasilAPI
climaTemperatura atual de qualquer cidade do mundoOpen-Meteo
fipeMarcas, modelos e preços da tabela FIPEBrasilAPI

Como usar

Remoto (HTTP — recomendado)

Endpoint público: https://mcp-brasil-fvll.onrender.com/mcp

Chave de API (uso livre durante a fase de validação):

sk-brasil-aa51f66d1b9de3dad09ee61d71099b3c

Aponte seu cliente MCP:

json
{  "mcpServers": {    "mcp-brasil": {      "type": "http",      "url": "https://mcp-brasil-fvll.onrender.com/mcp",      "headers": {        "Authorization": "Bearer sk-brasil-aa51f66d1b9de3dad09ee61d71099b3c"      }    }  }}

Local (stdio)

json
{  "mcpServers": {    "mcp-brasil": {      "command": "node",      "args": ["caminho/para/mcp-brasil/index.js"]    }  }}

Depois é só conversar:

"Qual o endereço do CEP 45822-622?" "O CNPJ 27.865.757/0001-79 está ativo?" "Qual o CEP da Rua Joana Angélica em Eunápolis?" "Faz frio em Gramado agora?"

Instalação

Requisitos: Node.js 18+.

bash
npm installnode index.js   # modo local (stdio)node web.js     # modo servidor web (HTTP)

Variáveis de ambiente do modo web:

VariávelFunção
PORTPorta do servidor (padrão 3000)
API_KEY_MCPChave exigida no cabeçalho Authorization: Bearer <chave>. Sem ela, o servidor roda sem segurança (só para teste local)

Testando sem cliente MCP

bash
node testar.js cep 01310100node testar.js clima "São Paulo"node testar.js cnpj 27865757000102node testar.js buscarcep "Joana Angelica" Eunapolis BA

Por que existe

As consultas brasileiras hoje vivem em sites com captcha, pop-up de assinatura e anúncio — feitos para humanos com paciência. Agentes de IA não clicam em anúncio nem resolvem captcha; precisam do dado limpo, em uma chamada. Este servidor é o "garçom": a IA pede, ele busca na fonte pública e entrega, 24h, sem tela nenhuma.

Todas as fontes são APIs públicas e gratuitas (ViaCEP, BrasilAPI, Open-Meteo). Sem cadastro, sem coleta de dados do usuário.

Licença

MIT

Source: README.md at commit e3c2034

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.2.0LatestOct 8, 2026