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"]
    }
  }
}

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

• Repositorio GitHub
• API Documentacao
• MCP Protocol