Uma lista de empresas quase sempre começa com uma pergunta de mercado.
Como padarias e confeitarias se distribuem entre as cidades de uma região? Onde abriram mais escritórios contábeis nos últimos anos? Quais CNPJs de uma planilha interna continuam ativos e quais ainda precisam ser pesquisados?
No cnpj.chat, você transforma a pergunta em filtros e salva o recorte como uma lista. Até agora, o passo seguinte normalmente era baixar um CSV e levar o arquivo para outra ferramenta.
Com o MCP do cnpj.chat, a lista entra na conversa.
Qualquer agente compatível com MCP pode consultar as listas da sua conta, percorrer as empresas e continuar o trabalho com o contexto e as ferramentas que você já usa na sessão.
O valor não está em consultar um CNPJ
Consultar uma empresa é útil. Trabalhar com um universo de empresas é outra coisa.
Uma lista salva pode representar um mercado inteiro: padarias e confeitarias do interior de São Paulo, escritórios contábeis abertos nos últimos três anos, hotéis de cidades litorâneas ou fabricantes de uma atividade específica.
Quando essa lista fica disponível para um agente, ela pode virar o ponto de partida para muitos trabalhos:
- estudar a distribuição de um setor por cidade ou região;
- comparar o mercado com uma planilha interna de clientes ou vendas;
- encontrar empresas que ainda não aparecem na base da sua operação;
- separar grupos para pesquisa e enriquecimento;
- revisar perfis antes de procurar sites, contatos ou emails em outras fontes;
- preparar tabelas, análises e próximos passos dentro da própria conversa.
O cnpj.chat fornece o recorte e os dados oficiais das empresas. Se você também entregar ao agente uma planilha de vendas, um relatório ou acesso a outras ferramentas, ele pode cruzar esses contextos. Enriquecimento de perfil, pesquisa de site e validação de email não vêm da Receita Federal nem do cnpj.chat. Eles podem acontecer depois, usando outras fontes disponíveis na sessão.
Essa separação importa. O agente sabe quais dados vieram da base oficial e quais foram encontrados ou produzidos em outro lugar.
Um exemplo
Você cria no /buscar uma lista chamada “Padarias e confeitarias do interior de São Paulo”. Depois conecta o cnpj.chat ao seu agente e pergunta:
Quais listas eu tenho no cnpj.chat?
Em seguida:
Percorra as empresas da lista Padarias e confeitarias do interior de São Paulo e organize por município e data de abertura.
Se você também anexar uma planilha com as regiões atendidas pela sua operação:
Compare as cidades da lista com esta planilha. Mostre onde existem muitas empresas, mas ainda não temos cobertura.
A lista define o universo de empresas. A planilha representa sua realidade. O agente trabalha na interseção.
Ele não precisa carregar todas as empresas de uma vez na conversa. Pode consultar a lista em páginas, trabalhar por etapas e pedir um CSV quando o volume exigir análise em lote.
O que o agente consegue fazer
O servidor MCP oferece seis ferramentas:
- consultar uma empresa pelo CNPJ;
- listar as listas salvas na sua conta;
- abrir uma lista e ler seus filtros;
- percorrer as empresas que fazem parte dela;
- pedir uma exportação em CSV;
- acompanhar a exportação até o arquivo ficar pronto.
As listas continuam privadas. Cada operação usa a conta que autorizou a conexão e só encontra listas e exportações daquele usuário.
Como conectar
Entre na sua conta e abra Conexões. A página mostra o comando para Claude Code, Codex e outros clientes MCP.
No Claude Code:
claude mcp add --transport http cnpj-chat https://api.cnpj.chat/mcp
No Codex:
codex mcp add cnpj-chat --url https://api.cnpj.chat/mcp
codex mcp login cnpj-chat
O login acontece por OAuth, com a mesma conta usada para salvar suas listas. Nenhuma chave de API é criada para a conexão.
Conectar, autorizar e descobrir as ferramentas não inicia o período de teste. O trial começa na primeira consulta válida aos dados e inclui sete dias e 2.000 operações.
O dado público continua no cnpj.chat. Agora o trabalho pode continuar onde a conversa já está acontecendo.