# 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`:
```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:
```json
{
"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
```bash
# 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](https://github.com/setor-embalagem/mcp-cnpj-intelligence)
- [API Documentacao](https://api-cnpj.sdebot.top/api/cnpj/health)
- [MCP Protocol](https://modelcontextprotocol.io)
