How do I install Brasil?

Brasil is a remote plugin. You do not need to install anything locally. Add the server URL to your AI app's MCP configuration and you are ready to go.

Is Brasil safe to use?

Yes. Brasil passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What AI apps work with Brasil?

Brasil uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Brasil MCP Server

by Viniciusmdoobm

Developer ToolsLow Risk10.0MCP RegistryRemote

Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://mcp-brasil-fvll.onrender.com/mcp

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (3 strong, 6 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Applies to the server that hosts this plugin, not to your machine.

Shell Command Execution

Runs commands on the server that hosts it, not on your machine.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-viniciusmdoobm-mcp-brasil": {
      "url": "https://mcp-brasil-fvll.onrender.com/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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

Ferramenta	O que faz	Fonte
`lookup_cep`	Endereço completo a partir do CEP	ViaCEP
`buscar_cep`	Encontra o CEP pelo nome da rua + cidade + UF	ViaCEP
`lookup_cnpj`	Razão social, situação cadastral, CNAE, capital social	BrasilAPI
`lookup_banco`	Nome do banco pelo código (260 → Nubank)	BrasilAPI
`taxas`	SELIC, CDI e IPCA atuais	BrasilAPI
`feriados`	Feriados nacionais de qualquer ano	BrasilAPI
`clima`	Temperatura atual de qualquer cidade do mundo	Open-Meteo
`fipe`	Marcas, modelos e preços da tabela FIPE	BrasilAPI

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:

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

Local (stdio)

{
  "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+.

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

Variáveis de ambiente do modo web:

Variável	Função
`PORT`	Porta do servidor (padrão 3000)
`API_KEY_MCP`	Chave exigida no cabeçalho `Authorization: Bearer <chave>`. Sem ela, o servidor roda sem segurança (só para teste local)

Testando sem cliente MCP

node testar.js cep 01310100
node testar.js clima "São Paulo"
node testar.js cnpj 27865757000102
node 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

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Stars

145

Installs