cnpj-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CNPJ_DADOS | No | Changes the origin of the data files. By default the MCP reads the Parquet files published on Hugging Face. It also accepts a local folder containing the .parquet files (for example saida/2026-10). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| consultar_cnpjA | Ficha completa de um CNPJ (razão social, situação, endereço, contatos, CNAEs, Simples/MEI, quadro de sócios). APIs públicas gratuitas com dados da Receita Federal: Minha Receita, com OpenCNPJ e CNPJá como reserva. A resposta indica a fonte usada. |
| buscar_empresas_por_filtroB | Lista estabelecimentos por UF, CNAE, município e/ou natureza jurídica (API Minha Receita, sem chave). Informe ao menos um filtro. Paginado: repita a chamada com o "cursor" devolvido para a próxima página. |
| buscar_socioA | Procura pessoas (ou empresas) no quadro societário pelo NOME. Agrupa homônimos por CPF mascarado e mostra faixa etária, quantas empresas e em quais UFs/municípios aparecem. Use antes de empresas_do_socio. Modos: exato (padrão, ~1-5 s), prefixo (começa com; idem) e contem (trecho em qualquer posição; baixa ~130 MB na primeira vez da sessão, de 10 a 30 s; não lista municípios). |
| empresas_do_socioA | Lista as empresas em que uma pessoa ou empresa figura como sócia, com situação e município. Informe o nome exato (como aparece em buscar_socio) e, de preferência, o CPF para excluir homônimos; ou só o CNPJ, para ver de quais empresas uma pessoa jurídica é sócia. |
| buscar_empresa_por_nomeA | Procura empresas pela razão social (modo contem também procura no nome fantasia da matriz). Devolve CNPJ da matriz, situação, município, natureza jurídica, porte e capital. Modos: prefixo (padrão, rápido), exato e contem. Evite contem: lê ~1 GB na primeira vez da sessão (cerca de 1 min pela internet); use-o só quando o começo do nome não for conhecido. |
| empresas_no_enderecoC | Estabelecimentos (matrizes e filiais) registrados num CEP, com filtro opcional por número e logradouro. Útil para achar empresas de fachada ou grupos no mesmo endereço. |
| socios_em_comumA | Cruza o quadro societário de várias empresas e aponta os sócios que aparecem em mais de uma (mesmo nome e mesmo documento mascarado). |
| rede_societariaA | Monta o grafo de vínculos societários a partir de uma empresa (cnpj) ou de uma pessoa (nome + cpf): empresas, sócios, empresas desses sócios, e assim por diante até a profundidade pedida. Sócios pessoa física são identificados por nome + CPF mascarado. |
| processos_djenA | Busca comunicações processuais (intimações, citações, distribuições) no Diário de Justiça Eletrônico Nacional (DJEN/CNJ) pelo nome da parte, agrupadas por processo. Com cnpj e incluir_socios=true, procura também pelos nomes dos sócios atuais (até 8). A busca é pelo NOME: pode trazer homônimos — confira as partes. A API pública aceita cerca de 20 consultas por minuto. |
| info_baseC | Mostra de que mês da Receita são os arquivos consultados, onde estão e quantas linhas têm. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Most tools target distinct query types: single CNPJ record, name search, UF/CNAE filter listing, address listing, partner search, and partner network. Mild overlap exists between buscar_empresas_por_filtro and buscar_empresa_por_nome (both list companies) and between socios_em_comum and rede_societaria (both about partner links), but descriptions clarify the boundaries.
All names are snake_case and in Portuguese, which is consistent. However, verb usage is mixed: buscar_socio / buscar_empresa_por_nome / buscar_empresas_por_filtro and consultar_cnpj are verb-first, while empresas_no_endereco, socios_em_comum, rede_societaria, processos_djen, and info_base are noun-first.
Ten tools is well-scoped for a CNPJ/company-data domain, with each tool covering a distinct query mode (lookup, search, network, processes). No obvious redundancy or padding.
The surface covers forward and reverse lookups (CNPJ by ID, company by name, companies by filter/address, partner by name, companies of a partner), network analysis, and data provenance via info_base. Minor gaps like batch lookup or export/aggregation helpers exist but core investigative workflows are covered.