Python · MCP · v0.1

cnpjaberto

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.

Ver no GitHub Configurar MCP SDK rápido

Use no Claude Desktop em 60 segundos

Instale o pacote

pip install cnpjaberto[mcp]

Cole isto no config do Claude Desktop

~/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.

Reinicie o Claude e pergunte qualquer coisa

"Consulta o CNPJ 18.236.120/0001-58 e me diz quando foi fundado e qual o CNAE principal."

"Quantas empresas brasileiras abriram em 2024 vs 2023? Quais estados mais cresceram?"

"Acha toda empresa ativa onde 'Maria Silva' aparece como sócia, agrupando por estado."

"Que outras empresas estão registradas no mesmo endereço da matriz do Magazine Luiza?"

Tools disponíveis

Tool	O que faz
`lookup_cnpj`	Registro completo: razão social, CNAE, endereço, sócios, capital, filiais
`list_filiais`	Filiais de uma matriz (paginado, filtro opcional por UF)
`search_companies`	Busca por razão social, fantasia ou dígitos do CNPJ
`companies_by_owner`	Empresas onde a pessoa aparece como sócia; CPF desambigua homônimos
`companies_at_same_address`	Outras empresas registradas no mesmo endereço
`companies_by_contact`	Empresas que compartilham o mesmo email ou telefone
`cnae_stats`	Estatísticas agregadas de um CNAE (contagem, top UFs, taxa de mortalidade)
`panorama_overview`	Estatísticas nacionais: top UFs, top CNAEs, faixas de capital, idade, histórico
`panorama_year`	Recorte anual: aberturas e fechamentos, série mensal, fatia MEI

Use o SDK direto

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")

Cliente assíncrono e endpoints Pro entram na v0.2. Acompanhe o progresso no repositório.

Fonte de dados

Todos os dados vêm do dump público de CNPJ da Receita Federal, atualizado mensalmente. O cnpjaberto.com.br ingere, indexa e serve com lookups sub-segundo, mais joins de valor agregado (grafo de sócios, endereços compartilhados, agregados por CNAE) sobre cerca de 70 milhões de estabelecimentos e 67 milhões de empresas.