Por que

Você vende algo para empresas e quer saber quem são os clientes possíveis na sua região:
quantas oficinas existem em Campinas, quais academias abriram este ano em São Paulo, onde
se concentram as clínicas odontológicas do estado.

A Receita Federal publica o cadastro de mais de 70 milhões de estabelecimentos, mas em
arquivos brutos de vários GB. O radar-cnpj-mcp transforma isso numa base local, consultada
em milissegundos, que o seu agente de IA entende.

• ⚡ Instantâneo: buscas em milissegundos, mesmo no Brasil inteiro
• 🔒 Local e gratuito: os dados ficam na sua máquina, sem mensalidade nem limite de resultados
• 🧠 Feito para IA: o agente traduz "oficina mecânica" para o CNAE certo e aplica os filtros
• 🇧🇷 Pensado para o Brasil: busca sem acentos, MEI separado de microempresa, CSV pronto para o Excel

Pergunte do seu jeito

Você: Quantas oficinas mecânicas ativas existem em Campinas?

Claude: 2.301 estabelecimentos com a atividade principal 4520-0/01 (manutenção e
reparação mecânica de veículos). Desses, 1.407 são MEIs e 783 são microempresas.

Outras ideias:

• "Liste academias abertas desde 2025 em Santo André, sem MEI, com telefone."
• "Em quais cidades de SP há mais clínicas odontológicas?"
• "Exporte para CSV os restaurantes do bairro Pinheiros."

Como usar

Requer Node.js 20 ou superior.

1. Baixe a base das UFs que interessam. Só as UFs pedidas, em segundos, a partir da base
pronta do radar-cnpj-dados:

npx -y radar-cnpj-mcp baixar --ufs SP,MG

2. Conecte ao seu agente de IA.

claude mcp add radar-cnpj -- npx -y radar-cnpj-mcp

{
  "mcpServers": {
    "radar-cnpj": {
      "command": "npx",
      "args": ["-y", "radar-cnpj-mcp"]
    }
  }
}

Pronto: peça ao agente o que procura. Para atualizar a base todo mês, rode o baixar de novo.

Instalação via npm

Se preferir instalar em vez de usar o npx:

npm install -g radar-cnpj-mcp
radar-cnpj-mcp baixar --ufs SP,MG

E configure o agente com o comando instalado:

claude mcp add radar-cnpj -- radar-cnpj-mcp

{
  "mcpServers": {
    "radar-cnpj": { "command": "radar-cnpj-mcp" }
  }
}

Para atualizar a ferramenta: npm update -g radar-cnpj-mcp.

Para usar um mês que ainda não está no radar-cnpj-dados, baixe a pasta do mês em
arquivos.receitafederal.gov.br (Dados › Cadastros ›
CNPJ, cerca de 7 GB) e importe:

npx -y radar-cnpj-mcp importar ~/Downloads/2026-10 --ufs SP,MG

A importação lê todos os arquivos da Receita, então leva alguns minutos mesmo para uma só UF.

O que o agente ganha

Filtros: CNAE (exato ou por prefixo, principal ou secundário), UF, município, bairro,
CEP, situação cadastral, data de abertura, porte, MEI, matriz/filial, capital social e
existência de telefone ou e-mail.

Atalhos (prompts): consultar_empresas, panorama_setor e empresas_recentes. No Claude
Code, viram comandos como /radar-cnpj:consultar_empresas.

Resources: radar://status, radar://cnaes, radar://municipios/{uf} e
radar://empresa/{cnpj}, para anexar à conversa.

No terminal

npx radar-cnpj-mcp contar --cnae 4520-0/01 --uf SP --agrupar municipio
npx radar-cnpj-mcp buscar --cnae 4520-0/01 --municipio Campinas --sem-mei --limite 20
npx radar-cnpj-mcp buscar --cnae 4520 --municipio Campinas --csv oficinas.csv
npx radar-cnpj-mcp status
npx radar-cnpj-mcp --help

Privacidade

Os dados são públicos e ficam só na sua máquina. Por padrão, telefone e e-mail de MEIs
ficam ocultos, porque costumam ser os da própria pessoa física. Ao usar os dados para
contatar empresas, respeite a LGPD: faça ofertas ligadas à atividade delas e ofereça uma forma
de não serem mais contatadas.

Desenvolvimento

npm install
npm test           # testes
npm run lint       # Biome
npm run typecheck
npm run build

Contribuindo

Contribuições são bem-vindas! Veja o CONTRIBUTING.md.

Licença

MIT. Dados: Receita Federal do Brasil – Dados Abertos do
CNPJ.

LGPD

O radar-cnpj-mcp foi feito com a LGPD em mente:

• usa a base pública de CNPJ publicada pela Receita Federal e não inclui os dados de sócios;
• remove dos dados os números em formato de CPF;
• mantém ocultos o telefone e o e-mail de MEIs, que não são publicados nos dados prontos.

A razão social de MEIs e empresários individuais pode conter o nome da pessoa, como consta na
base da Receita. Cada usuário é responsável por usar os dados de acordo com a LGPD. Este aviso
não é um parecer jurídico.