SDK em Python e servidor Model Context Protocol para o cnpjaberto.com.br, o cadastro aberto de empresas brasileiras (CNPJ). Consulte empresas, grafo de sócios, endereços e estatísticas nacionais a partir do Claude Desktop, do Cursor ou de qualquer script Python.
pip install 'cnpjaberto[mcp]'
~/Library/Application Support/Claude/claude_desktop_config.json
(macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"cnpjaberto": {
"command": "cnpjaberto-mcp",
"env": {
"CNPJABERTO_API_KEY": "sua_chave_aqui"
}
}
}
}A chave é obrigatória. Crie uma conta gratuita em cnpjaberto.com.br/planos e copie sua chave.
| Tool | O que faz |
|---|---|
lookup_cnpj | Consulta CNPJ completo (14 caracteres, numérico ou alfanumérico). Com API key, estabelecimentos contém apenas o estabelecimento solicitado. Use filiais para paginar os demais. Sócios e demais campos são preservados. |
list_filiais | Filiais por CNPJ completo; filtro UF e busca textual q. Página/tamanho: 1–200. |
companies_by_owner | Empresas onde a pessoa aparece como sócia. ``cpf`` em dígitos (parcial é aceito) ajuda a desambiguar homônimos; ``exclude`` remove um ``cnpj_basico`` específico do resultado. |
companies_at_same_address | PRO: empresas registradas no mesmo endereço (CEP, logradouro, número). ``cep`` precisa ter exatamente 8 dígitos, sem traço. |
companies_by_contact | PRO: empresas que compartilham um contato. Informe ``email`` OU (``ddd`` E ``telefone``); a busca por telefone exige o DDD separado. |
cnae_stats | Estatísticas agregadas de um CNAE (contagem, top UFs, etc.). |
panorama_overview | Panorama nacional: totais, top UFs, top CNAEs, faixas de capital. |
panorama_year | Recorte anual: aberturas, fechamentos, série mensal, top CNAEs e UFs. |
owner_summary | Resumo das empresas de um sócio; CPF parcial ajuda a desambiguar homônimos. |
owner_summaries | Resumo em lote de até 10.000 sócios (nome e cpf opcional). A ordem dos resultados corresponde à ordem de items. Consulta sem escrita. |
participations | PRO: empresas que têm este CNPJ como sócio pessoa jurídica. |
cnae_catalog | Catálogo CNAE; secao opcional A–U. Sem seção, retorna todo o catálogo. |
control_tree | PRO: árvore de controle societário da empresa. |
common_owners | PRO: cruza sócios de 2 ou mais raízes distintas. modo: intersecao ou sobreposicao; min_empresas: 2–50. |
advanced_search | Busca por filtros combinados. Informe pelo menos um filtro seletivo. UF aceita até 5 estados separados por vírgula; CNAE, situação e porte também aceitam vírgulas. Contato/endereço exato e filtros com_email/com_telefone exigem PRO. Prefira municipio_codigo e municipio_uf ao nome parcial. |
competitors | Até 8 concorrentes da empresa; o backend não aceita parâmetro limit. |
person_profile | Raio-X da pessoa por nome e CPF parcial. Free retorna prévia; PRO retorna análise completa. Preserve os indicadores de bloqueio da resposta. |
search_owners | Busca sócios por nome ou CPF/CNPJ. Exige nome ou documento; refine nomes amplos com sobrenome ou cidade. faixa_etaria aceita códigos 1–9 separados por vírgula. |
owner_suggestions | Sugestões de sócios e MEI/EI por nome (mínimo 3 caracteres). |
leads | Prospecção por UF e município obrigatórios. Resolva municipio_codigo com search_municipalities. Free mascara contatos (contact_gated); PRO libera contato. Não trate valores mascarados como contatos reais. Datas de abertura em YYYY-MM-DD. |
search_cnaes | Busca código ou descrição CNAE; retorna lista de código e descrição. |
search_municipalities | Busca nome de município, opcionalmente por UF. Retorna códigos para leads e advanced_search. |
municipalities | Municípios de uma UF com códigos e descrições; retorna lista. |
companies_by_city | PRO: empresas do município (código), com busca por nome, logradouro e bairro. |
service_catalog | Catálogo de serviços com slugs para search_services. |
search_services | Empresas por slug de serviço, UF e código de município. sem_mei exclui MEIs. |
business_group | PRO: mapa do grupo empresarial por vínculos societários. Mapas amplos podem retornar 503. |
red_flags | Indicadores cadastrais de atenção da empresa. São sinais para análise, não prova de irregularidade. |
ownership_network | Rede societária por nome ou CPF. Use cpf parcial para reduzir homônimos; refine buscas amplas. |
compliance_summary | Resumo de sanções diretas e dívida ativa da própria pessoa jurídica; sem PEP de sócios. |
compliance_dossier | PRO: dossiê de sanções públicas, PEP dos sócios e indicadores de atenção. |
active_debt | Dívida ativa PGFN. encontrado=false é resultado válido, não erro 404. |
panorama_catalog | Catálogo de períodos e edições publicados; use antes de solicitar relatórios. |
panorama_report | Relatório publicado por período, UF (BR por padrão), recorte, tema e edição. Consulte panorama_catalog para valores disponíveis. |
panorama_csv | CSV do relatório publicado; retorna texto, não JSON. tabela padrão cnaes. Consulte panorama_catalog para períodos e recortes disponíveis. |
panorama_revisions | Revisões publicadas de um período do panorama. |
panorama_alphanumeric | Painel de CNPJs alfanuméricos: totais e série mensal do ano solicitado. |
stock_catalog | Catálogo B3; tipo opcional ACAO, FII, BDR, UNT ou ETF. |
stock_ticker | Detalhe de ticker B3, incluindo fundo para FII e tickers relacionados. |
fund_catalog | Catálogo CVM: FII, FIF, FIDC, FIP, FIAGRO ou FIIM. situacao=all inclui fundos inativos. |
fund | Detalhe de fundo CVM por CNPJ numérico completo. |
funds_by_auditor | Outros fundos ativos auditados pela mesma firma, ordenados por patrimônio. |
similar_funds | Fundos similares por categoria e patrimônio líquido. |
search_companies | Busca por razão social, fantasia ou dígitos do CNPJ. ``q`` exige no mínimo 4 caracteres; ``per_page`` é limitado a 20. |
from cnpjaberto import Client
with Client() as cnpj: # lê CNPJABERTO_API_KEY do ambiente
nubank = cnpj.lookup("18.236.120/0001-58")
matriz = nubank["estabelecimentos"][0]
print(nubank["razao_social"], matriz["situacao_cadastral"])
snap = cnpj.panorama_year(2024)
print(f"{snap['abertas']:,} abertas, {snap['fechadas']:,} fechadas em 2024")A versão 0.2.0 oferece 44 ferramentas e acesso aos endpoints PRO com a chave da conta. Leads e Raio-X podem retornar prévias no Free. Exportações privadas e gestão da chave ainda dependem da sessão web e não são expostas pelo MCP. Veja contratos, limites e migração no README.
Cadastro da Receita Federal, complementado por dados de compliance, dívida ativa, B3/CVM e publicações do panorama. Consulte cobertura e atualização nos metadados das respostas. Indicadores cadastrais não constituem prova de irregularidade.