Skip to main content
Glama
radar-cnpj-mcp

radar-cnpj-mcp

by wendersoon

📡 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.

CI MCP Node Licença: MIT

Um agente de IA usando o radar-cnpj-mcp para consultar oficinas mecânicas em Campinas

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,MG

Sã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.

  1. Abra a pasta do CNPJ na Receita Federal e entre na pasta do mês mais recente (por exemplo, 2026-10).

  2. Baixe, para uma mesma pasta, os arquivos Estabelecimentos*.zip, Empresas*.zip, Simples.zip, Cnaes.zip e Municipios.zip. Não é preciso descompactar. Os demais, como Socios*.zip, não são usados.

  3. Importe a pasta:

npx -y radar-cnpj-mcp importar ~/Downloads/2026-10 --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.

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,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.

O que o agente ganha

Ferramenta

O que faz

buscar_empresas

Lista empresas com CNPJ, razão social, atividade, endereço e contatos

contar_empresas

Conta empresas, agrupando por UF, município, bairro, CNAE, porte, MEI ou ano

buscar_cnae

Descobre o código CNAE a partir da descrição da atividade

buscar_municipio

Encontra municípios pelo nome

detalhar_empresa

Mostra todos os dados de um CNPJ

exportar_csv

Gera uma planilha CSV pronta para o Excel

status_base

Informa o mês de referência e as UFs importadas

perfil_municipio

Resume a economia de um município: setores, porte, MEIs e aberturas recentes

comparar_regioes

Compara até 5 municípios ou UFs, no mesmo setor ou em todos

tendencia_setor

Mostra aberturas e baixas por ano ou mês, a partir da base atual

baixar_dados

Baixa os dados da Receita em segundo plano, a pedido do usuário

andamento_download

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

Contagem de empresas e oficinas mecânicas em São Paulo pelo 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 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 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 é 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 tools
andamento_downloadAndamento do downloadA
Read-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 ReceitaA
Destructive

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 CNAEA
Read-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 empresasA
Read-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ípioB
Read-only

Encontra municípios pelo nome (busca parcial, sem diferenciar acentos) entre as UFs importadas.

Inputs: nome (required), uf, limite.

comparar_regioesComparar regiõesA
Read-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 empresasA
Read-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 empresaA
Read-only

Mostra todos os dados de um estabelecimento pelo CNPJ, incluindo atividades secundárias.

Inputs: cnpj (required), ocultar_contatos_mei.

exportar_csvExportar CSVB
Idempotent

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ípioA
Read-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 baseA
Read-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 setorA
Read-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

    A3.8/5.0

    Scored across 12 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Brazilian company-registry lookup via Receita Federal, allowing AI agents to query CNPJ data.
      59 npm
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      5
      288 npm
      MIT