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- Supermercados5611201- Restaurantes2222600- Embalagens plasticas1733800- Embalagens papelao4751201- Comercio de informatica6201501- 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
- Fork o repositorio
- Crie uma branch:
git checkout -b feature/nova-funcionalidade - Commit:
git commit -m 'feat: adiciona nova funcionalidade' - Push:
git push origin feature/nova-funcionalidade - Abra um Pull Request
License
MIT - Setor da Embalagem 2024