radar-cnpj-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@radar-cnpj-mcp Quantas oficinas mecânicas ativas existem em Campinas?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
📡 radar-cnpj-mcp
Encontre empresas por atividade e região na base pública de CNPJ da Receita Federal, direto do seu agente de IA ou do terminal.

Por que
Você quer entender quais empresas existem em um setor ou região: quantas oficinas há 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
Related MCP server: mcp-empresas-brasil
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 é a economia de Campinas?"
"Onde há mais clínicas odontológicas: Campinas, Santos ou Sorocaba?"
"As aberturas de academias em SP estão crescendo?"
Como usar
Requer Node.js 20 ou superior.
1. Baixe os dados da Receita Federal. O comando busca os arquivos do mês mais recente direto da Receita e monta a base na sua máquina, só com as UFs pedidas. O projeto não hospeda nem redistribui os dados.
npx -y radar-cnpj-mcp baixar --ufs SP,MGSão cerca de 7 GB de download, mesmo para uma só UF, porque a Receita não separa os arquivos por
estado. Reserve cerca de 20 GB livres durante o processo; ao final, os arquivos temporários são
apagados e fica só a base (1,9 GB para SP e AC). Com SP e AC, levou cerca de 33 minutos, dos quais
18 de download; o tempo depende da sua conexão e da máquina. Para guardar os ZIPs, use
--manter-arquivos <pasta>. Para o Brasil inteiro, troque --ufs por --todas, o que exige mais
tempo e espaço.
Abra a pasta do CNPJ na Receita Federal e entre na pasta do mês mais recente (por exemplo,
2026-10).Baixe, para uma mesma pasta, os arquivos
Estabelecimentos*.zip,Empresas*.zip,Simples.zip,Cnaes.zipeMunicipios.zip. Não é preciso descompactar. Os demais, comoSocios*.zip, não são usados.Importe a pasta:
npx -y radar-cnpj-mcp importar ~/Downloads/2026-10 --ufs SP,MG2. 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.
Também dá para pedir ao agente: "Baixe os dados da Receita para SP e MG." Ele confirma com você e o download continua em segundo plano, mesmo se você fechar o agente. Cada download substitui a base atual, então inclua todas as UFs que quiser manter.
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,MGE 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.
O que o agente ganha
Ferramenta | O que faz |
| Lista empresas com CNPJ, razão social, atividade, endereço e contatos |
| Conta empresas, agrupando por UF, município, bairro, CNAE, porte, MEI ou ano |
| Descobre o código CNAE a partir da descrição da atividade |
| Encontra municípios pelo nome |
| Mostra todos os dados de um CNPJ |
| Gera uma planilha CSV pronta para o Excel |
| Informa o mês de referência e as UFs importadas |
| Resume a economia de um município: setores, porte, MEIs e aberturas recentes |
| Compara até 5 municípios ou UFs, no mesmo setor ou em todos |
| Mostra aberturas e baixas por ano ou mês, a partir da base atual |
| Baixa os dados da Receita em segundo plano, a pedido do usuário |
| Mostra a etapa do download iniciado pelo agente |
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 --helpPrivacidade
Os dados vêm direto da Receita Federal e ficam na sua máquina. Se o seu agente de IA roda na
nuvem, os resultados das consultas são enviados ao provedor dele. Telefone e e-mail de MEIs
costumam ser os da própria pessoa física: para ocultá-los, peça ao agente ou use
--ocultar-contatos-mei no terminal. 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 buildContribuindo
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 é uma ferramenta de código aberto. O projeto não hospeda nem coleta dados: cada pessoa baixa a base pública de CNPJ direto da Receita Federal e consulta na própria máquina.
Por isso, não temos dados para excluir ou filtrar. Pedidos de alteração ou remoção devem ser feitos à Receita Federal.
Quem usa a ferramenta responde pelo próprio uso dos dados, inclusive perante a LGPD.
Os dados de sócios não são importados. A razão social de MEIs e empresários individuais pode conter o nome da pessoa, e os contatos de MEIs costumam ser os dela, como constam na base da Receita. Este aviso não é um parecer jurídico.
Available Tools
12 toolsandamento_downloadAndamento do downloadARead-only
Informa o estado do último download iniciado (baixando, concluido, erro ou interrompido) e a etapa atual.
Inputs: no named parameters.
baixar_dadosBaixar dados da ReceitaADestructive
Baixa os arquivos da Receita Federal e monta a base local, em segundo plano. São cerca de 7 GB de download, mesmo para uma só UF, e são necessários cerca de 20 GB livres durante o processo, que costuma levar mais de meia hora. SUBSTITUI a base atual quando termina: informe todas as UFs desejadas, inclusive as já importadas. Só use depois que o usuário confirmar as UFs e o download. Acompanhe com andamento_download; a base atual continua disponível até o fim.
Inputs: mes, ufs, todas.
buscar_cnaeBuscar CNAEARead-only
Encontra códigos CNAE pela descrição da atividade (ex.: "oficina mecânica", "odontologia") ou pelo início do código (ex.: "4520").
Inputs: termo (required), limite.
buscar_empresasBuscar empresasARead-only
Lista empresas (estabelecimentos) que atendem aos filtros, com CNPJ, razão social, atividade, endereço e contatos cadastrados na Receita. O campo total é a contagem exata de todas as empresas que atendem aos filtros, sem amostragem nem teto; limite e deslocamento só controlam quais delas vêm na lista.
Inputs: mei, ufs, ceps, cnaes, +16 more.
buscar_municipioBuscar municípioBRead-only
Encontra municípios pelo nome (busca parcial, sem diferenciar acentos) entre as UFs importadas.
Inputs: nome (required), uf, limite.
comparar_regioesComparar regiõesARead-only
Compara até 5 municípios ou UFs, no mesmo setor ou em todos: empresas ativas, porte, percentual de MEIs, peso do setor nas ativas da região e aberturas dos últimos 12 meses completos comparadas aos 12 anteriores. Retorna só totais, sem listar empresas.
Inputs: regioes (required), cnaes, incluir_cnae_secundario.
contar_empresasContar empresasARead-only
Conta as empresas que atendem aos filtros, opcionalmente agrupando por UF, município, bairro, CNAE, porte, MEI ou ano de abertura. As contagens são exatas sobre toda a base importada, sem amostragem nem teto (números redondos são coincidência); maximo_grupos só limita quantos grupos são listados. Ideal para ver totais e distribuições.
Inputs: mei, ufs, ceps, cnaes, +14 more.
detalhar_empresaDetalhar empresaARead-only
Mostra todos os dados de um estabelecimento pelo CNPJ, incluindo atividades secundárias.
Inputs: cnpj (required), ocultar_contatos_mei.
exportar_csvExportar CSVBIdempotent
Grava as empresas que atendem aos filtros num arquivo CSV (separado por ";", pronto para Excel) na pasta /root/radar-cnpj-mcp e retorna o caminho.
Inputs: mei, ufs, ceps, cnaes, +16 more.
perfil_municipioPerfil do municípioARead-only
Resume a economia de um município em uma chamada: empresas ativas, principais setores, porte, percentual de MEIs, situação cadastral e aberturas dos últimos 12 meses completos comparadas aos 12 anteriores. Retorna só totais, sem listar empresas.
Inputs: municipio (required), uf, principais_setores.
status_baseStatus da baseARead-only
Informa o mês de referência dos dados, as UFs importadas e o total de estabelecimentos.
Inputs: no named parameters.
tendencia_setorTendência do setorARead-only
Mostra aberturas e baixas por ano ou mês, a partir das datas da base atual, e compara os últimos 12 meses completos aos 12 anteriores. Use para saber se um setor ou região está crescendo. Período marcado como parcial não é comparável aos demais. Retorna só totais, sem listar empresas.
Inputs: mei, ufs, cnaes, periodos, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools target a distinct operation: raw listing (buscar_empresas), exact counting (contar_empresas), single-company detail (detalhar_empresa), and aggregate summaries (perfil_municipio, comparar_regioes, tendencia_setor). There is some residual overlap — contar_empresas can group by 'ano de abertura', which partially duplicates tendencia_setor, and perfil_municipio's 12-month openings repeat tendencia_setor's core metric — but descriptions make the intended use clear enough to choose correctly.
All names are lowercase snake_case, which is good, but the pattern mixes verb_noun (buscar_empresas, contar_empresas, detalhar_empresa, comparar_regioes) with noun_noun forms (status_base, andamento_download, perfil_municipio, tendencia_setor). The mixing is readable but not predictable from the name alone.
Twelve tools is well-scoped for a CNPJ registry exploration server: ingestion (baixar_dados, andamento_download, status_base), discovery helpers (buscar_cnae, buscar_municipio), data access (buscar_empresas, contar_empresas, detalhar_empresa, exportar_csv), and analytics (perfil, comparar, tendencia). Each earns its place.
The lifecycle is well covered: download and monitor the base, check status, resolve CNAE/municipality filters, list/count/detail/export companies, and run aggregate analytics. Minor gaps remain — no way to inspect or cancel an in-progress download, no listing of available UFs or reference months per UF beyond status_base, and no shareholder (sócios/QSA) lookup — but agents can work around these.
Maintenance
Related MCP Connectors
Brazil's open CNPJ registry: filter and count companies by sector, place, size, MEI, partners.
Free lookup of 28.4M active Brazilian companies by CNPJ or name (Receita Federal open data).
Find Brazilian companies by business activity (CNAE), location, company size, and registration status, using data from Brazil’s Federal Revenue Service. The Oportunidados MCP connector offers 24 tools to search and consult companies, view account information, and work in the account’s CRM. It reads company data and reads and writes CRM records, including deletions. Write and delete tools are labeled as such, so your AI client can ask for confirmation.
Free Brazilian CNPJ lookup (legal name, status, partners) + lawsuit discovery. Public data, no login
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceBrazilian company-registry lookup via Receita Federal, allowing AI agents to query CNPJ data.59 npmMIT
- AlicenseBqualityBmaintenanceEnables querying Brazil's official CNPJ company registry data, counting and listing establishments by municipality, state, CNAE activity, size, or status, with caveats about official dump limitations such as non-IBGE municipality codes and secondary activities.4MIT

apipj MCP serverofficial
AlicenseNot gradedqualityCmaintenanceEnables lookup and validation of Brazilian companies by CNPJ, returning registration status, address, CNAE activities, Simples Nacional/MEI status, and partners from monthly Receita Federal open data, plus validation of numeric or alphanumeric CNPJ check digits and search of active companies by activity and municipality.MIT- AlicenseAqualityBmaintenanceEnables AI assistants to query Brazilian public data through BrasilAPI, including company registry details and partners by CNPJ, addresses by CEP, and national holidays. It also performs offline CNPJ/CPF validation before any network request and does not store queried numbers.5288 npmMIT