README.md
Query data on 27 million Brazilian companies from the Federal Revenue
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
Links
Tools (16)
buscar_empresaSearch company registration data by CNPJempresa_completaGet complete data including partners and tax regimefiliaisList all branches of a companysociosGet complete partner informationregime_tributarioCheck Simples Nacional and MEI statusbuscar_por_nomeSearch by company name or trade namebuscar_por_cnaeSearch companies by specific industry sectorbuscar_por_socioSearch companies by partner namebuscar_por_cepSearch companies by region using CEPbuscar_avancadoSearch using multiple combined filtersbenchmark_empresaCompare a company with the sector averagebuscar_similaresFind similar companies (lookalike analysis)ranking_cnaeGet ranking of the largest companies in a sectorestatisticas_por_ufGet company counts by stateestatisticas_por_cnaeGet sectors with the most companiesbulk_lookupConsult multiple CNPJs at once (max 100)Configuration
claude_desktop_config.json
{"mcpServers": {"cnpj": {"command": "npx", "args": ["-y", "mcp-cnpj-intelligence"]}}}Try it
→Get the registration details for the company with CNPJ 00.000.000/0001-91.
→List the 10 largest plastic packaging industries located in São Paulo.
→Find companies similar to CNPJ 12345678 with a similarity score of at least 60.
→Which companies in the supermarket sector are located in the CEP 01310-100?