Skip to main content
Glama
Sign In
MCP CNPJ Intelligence

MCP CNPJ Intelligence

by raphaelmarra
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

MCP CNPJ Intelligence

MCP Server para consulta de 27 milhoes de empresas brasileiras da Receita Federal.

Integre dados de CNPJs diretamente no Claude Desktop, Cursor, ou qualquer cliente MCP.

Instalacao Rapida

Claude Desktop

Adicione ao seu claude_desktop_config.json:

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

Localizacao do arquivo:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

Cursor / VS Code

Adicione ao arquivo de configuracao MCP:

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

Related MCP server: brdata-mcp

Ferramentas Disponiveis

Consulta Basica

Ferramenta

Descricao

buscar_empresa

Busca dados cadastrais por CNPJ

empresa_completa

Dados completos + socios + regime tributario

filiais

Lista todas filiais de uma empresa

socios

Quadro societario completo

regime_tributario

Simples Nacional e MEI

Busca e Descoberta

Ferramenta

Descricao

buscar_por_nome

Busca por razao social ou nome fantasia

buscar_por_cnae

Empresas de um setor especifico

buscar_por_socio

Empresas por nome do socio

buscar_por_cep

Empresas em uma regiao (CEP)

buscar_avancado

Multiplos filtros combinados

Analise e Benchmark

Ferramenta

Descricao

benchmark_empresa

Compara empresa com media do setor

buscar_similares

Encontra empresas similares (lookalike)

ranking_cnae

Ranking das maiores do setor

Estatisticas

Ferramenta

Descricao

estatisticas_por_uf

Quantidade de empresas por estado

estatisticas_por_cnae

Setores com mais empresas

bulk_lookup

Consulta multiplos CNPJs (max 100)

Exemplos de Uso

No Claude Desktop

Busque informacoes da empresa com CNPJ 00.000.000/0001-91
Liste as 10 maiores industrias de embalagens plasticas em SP
Encontre empresas similares a CNPJ 12345678 com score minimo de 60
Quais empresas do setor de supermercados estao no CEP 01310-100?

CNAEs Comuns

  • 4711302 - Supermercados

  • 5611201 - Restaurantes

  • 2222600 - Embalagens plasticas

  • 1733800 - Embalagens papelao

  • 4751201 - Comercio de informatica

  • 6201501 - Desenvolvimento de software

API Publica

Este MCP consome a API publica:

https://api-cnpj.sdebot.top

Nao requer autenticacao. Rate limit: 60 req/min.

Desenvolvimento Local

# Clone o repositorio
git clone https://github.com/setor-embalagem/mcp-cnpj-intelligence.git
cd mcp-cnpj-intelligence

# Instale dependencias
npm install

# Rode em modo desenvolvimento
npm run dev

# Rode testes
npm test

# Build para producao
npm run build

Estrutura do Projeto

mcp-cnpj-intelligence/
├── src/
│   └── index.ts          # Servidor MCP
├── tests/
│   └── golden-path.test.ts
├── docs/
│   └── adr/              # Architecture Decision Records
├── .github/
│   └── workflows/
│       └── ci.yml        # CI/CD
├── package.json
├── tsconfig.json
└── README.md

Contribuindo

  1. Fork o repositorio

  2. Crie uma branch: git checkout -b feature/nova-funcionalidade

  3. Commit: git commit -m 'feat: adiciona nova funcionalidade'

  4. Push: git push origin feature/nova-funcionalidade

  5. Abra um Pull Request

License

MIT - Setor da Embalagem 2024

Links

Available Tools

16 tools
benchmark_empresaA

Compara empresa com a MEDIA DO SETOR.

QUANDO USAR:

  • Quer saber se empresa esta acima ou abaixo da media

  • Analise comparativa de porte/capital

RETORNA:

  • Dados da empresa

  • Estatisticas do setor (media, mediana, total)

  • Posicao relativa no ranking

Inputs: cnpj (required), uf.

bulk_lookupA

Consulta MULTIPLOS CNPJs de uma vez (lote).

QUANDO USAR:

  • Tem uma lista de CNPJs para enriquecer

  • Importando dados de planilha/CRM

LIMITES:

  • Maximo 100 CNPJs por requisicao

Inputs: cnpjs (required).

buscar_avancadoA

Busca com MULTIPLOS FILTROS combinados.

QUANDO USAR:

  • Precisa de filtros que outras ferramentas nao oferecem

  • Query complexa combinando varios criterios

FILTROS DISPONIVEIS:

  • cnae, uf, municipio, porte

  • capital_min/capital_max

  • situacao, limite

Inputs: cnae, uf, municipio, porte, +4 more.

buscar_empresaA

Busca dados cadastrais de uma empresa brasileira pelo CNPJ.

QUANDO USAR:

  • Voce tem um CNPJ especifico e precisa dos dados cadastrais

  • Precisa validar se um CNPJ existe e esta ativo

  • Quer saber razao social, endereco, CNAE, porte de uma empresa

RETORNA:

  • cnpj, razao_social, nome_fantasia

  • endereco completo (logradouro, municipio, uf, cep)

  • cnae_principal, data_abertura, capital_social

  • situacao_cadastral, porte_empresa

EXEMPLO: { "cnpj": "00000000000191" } (Banco do Brasil)

Inputs: cnpj (required).

buscar_por_cepA

Busca empresas por CEP.

QUANDO USAR:

  • Quer empresas em uma regiao especifica

  • Prospeccao geografica localizada

PARAMETROS:

  • cep: CEP de 8 digitos

  • cnae: Filtrar por CNAE (opcional)

  • situacao: Filtrar por situacao cadastral (padrao: 02=ativas)

  • limite: Quantidade maxima (padrao: 50)

Inputs: cep (required), cnae, situacao, limite.

buscar_por_cnaeA

Lista empresas de um SETOR especifico (por CNAE).

QUANDO USAR:

  • Quer todas empresas de uma atividade economica

  • Prospeccao por vertical/segmento

CNAES COMUNS:

  • 4711302: Supermercados

  • 5611201: Restaurantes

  • 2222600: Embalagens plasticas

  • 4751201: Comercio de informatica

Inputs: cnae (required), uf, limite.

buscar_por_nomeA

Busca empresas pelo NOME (razao social ou nome fantasia).

QUANDO USAR:

  • Sabe o nome mas nao o CNPJ

  • Quer encontrar todas as unidades de uma rede

PARAMETROS:

  • nome: Termo de busca (minimo 3 caracteres)

  • uf: Filtrar por estado (opcional)

  • limite: Quantidade maxima (padrao: 50)

Inputs: nome (required), uf, limite.

buscar_por_socioA

Busca empresas por NOME DE SOCIO.

QUANDO USAR:

  • Quer encontrar todas empresas de um empresario

  • Precisa mapear portfolio de um investidor

PARAMETROS:

  • nome: Nome do socio (minimo 3 caracteres)

  • uf: Filtrar por estado (opcional)

  • limite: Quantidade maxima (padrao: 50)

Inputs: nome (required), uf, limite.

buscar_similaresA

Encontra empresas SIMILARES usando scoring multi-dimensional.

QUANDO USAR:

  • Tem um cliente bom e quer encontrar mais parecidos (lookalike)

  • Quer expandir carteira com empresas do mesmo perfil

ALGORITMO DE SIMILARIDADE:

  • Mesmo CNAE (atividade economica)

  • Mesmo porte (capital social similar)

  • Mesma regiao

Inputs: cnpj (required), limite, score_minimo, uf.

empresa_completaA

Retorna dados COMPLETOS de uma empresa: cadastro + socios + regime tributario.

QUANDO USAR:

  • Precisa de informacoes detalhadas para due diligence

  • Quer saber quem sao os socios e suas participacoes

  • Precisa verificar se empresa e Simples Nacional ou MEI

RETORNA:

  • Todos os dados de buscar_empresa +

  • Lista de socios com nome, cpf/cnpj, qualificacao

  • Regime tributario: simples_nacional, mei

Inputs: cnpj (required).

estatisticas_por_cnaeA

Retorna SETORES com mais empresas (ranking de CNAEs).

QUANDO USAR:

  • Identificando mercados maiores

  • Analise de oportunidade por vertical

PARAMETROS:

  • limite: Top N CNAEs (padrao: 20)

Inputs: limite.

estatisticas_por_ufA

Retorna QUANTIDADE de empresas por estado brasileiro.

QUANDO USAR:

  • Analise de mercado por regiao

  • Priorizando estados para expansao

RETORNA:

  • Lista de UFs com quantidade de empresas ativas

  • Ordenado por quantidade (maior primeiro)

Inputs: no named parameters.

filiaisA

Lista todas as filiais de uma empresa (mesmo CNPJ base).

QUANDO USAR:

  • Quer mapear a presenca geografica de uma empresa

  • Precisa saber quantas unidades uma empresa tem

RETORNA:

  • Lista de todas filiais com cnpj completo, endereco, situacao

Inputs: cnpj (required).

ranking_cnaeB

RANKING das maiores empresas de um setor.

QUANDO USAR:

  • Quer identificar os lideres de mercado

  • Account-Based Marketing (ABM)

ORDENACAO:

  • capital: Por capital social (padrao)

  • filiais: Por quantidade de unidades

Inputs: cnae (required), uf, limite, ordenar_por.

regime_tributarioA

Verifica regime tributario: Simples Nacional ou MEI.

QUANDO USAR:

  • Precisa saber se empresa pode emitir NF simplificada

  • Quer filtrar empresas por regime

RETORNA:

  • simples_nacional: true/false

  • mei: true/false

  • datas de opcao/exclusao

Inputs: cnpj (required).

sociosA

Lista o quadro societario completo de uma empresa.

QUANDO USAR:

  • Quer identificar quem sao os donos/socios

  • Precisa do CPF/CNPJ dos socios para outras buscas

RETORNA:

  • Lista de socios com: nome, cpf_cnpj, qualificacao, data_entrada

Inputs: cnpj (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools have distinct purposes, such as buscar_empresa for basic company data and empresa_completa for detailed information including shareholders. However, some overlap exists between buscar_avancado and other search tools like buscar_por_cnae or buscar_por_cep, which could cause confusion despite their descriptions clarifying specific use cases.

    Naming Consistency4/5

    The tool names follow a consistent snake_case pattern throughout, with clear verb_noun structures like buscar_empresa and estatisticas_por_cnae. Minor deviations include benchmark_empresa and bulk_lookup, which slightly break the pattern but are still readable and understandable.

    Tool Count4/5

    With 16 tools, the count is slightly high but reasonable for a comprehensive CNPJ intelligence server covering various aspects like company lookup, advanced searches, statistics, and shareholder information. It provides a rich feature set without being overwhelmingly excessive.

    Completeness5/5

    The tool set offers complete coverage for CNPJ intelligence, including basic and advanced company lookups, sector and geographic analyses, shareholder information, benchmarking, and tax regime checks. There are no obvious gaps, and the tools support a full range of business intelligence workflows.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • cnpjaberto

      cnpjabertoofficial

      cnpjaberto
      A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for querying Brazilian CNPJ company data, including partner graphs, address/contact joins, CNAE statistics, and national/annual overviews.
      MIT

    • brdata-mcp

      thomenz
      A
      license
      A
      quality
      D
      maintenance
      An MCP server for Brazilian company and public procurement data, enabling CNPJ lookup, company search, tender resolution, and more via paid USDC-based API calls.
      15
      80 npm
      MIT

    • mcp-brasil-gateway

      netopanforte-max
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that provides access to Brazilian public and commercial data, including CNPJ company info, government procurement (PNCP) searches, and FIPE vehicle pricing, with optional alert registration for new tenders.
      MIT

    Appeared in Searches