Como dar a um agente acesso à base de empresas do Brasil em um comando (MCP)
O agente precisa responder perguntas como "essa empresa existe, está ativa, faz o quê, fica onde e como entro em contato". A resposta existe na base da Receita Federal. O problema é o caminho até ela. As opções manuais cobram pedágio. Planilha baixada perde a data de referência na segunda semana. Scraper de portal quebra no primeiro redesign. CSV mensal pesa gigabytes e exige pipeline próprio. E…
Para permitir que um agente acesse a base de empresas do Brasil através de um comando único e seguro, o cnpj.ia.br fornece um servidor MCP remoto. Este servidor expõe ferramentas compatíveis com HTTP, que o agente pode chamar usando uma chave de conta armazenada no cliente. As quatro ferramentas disponíveis são: consultar_cnpj, buscar_empresas, gerar_filtro e ver_uso.
Cada uma delas tem um objetivo específico e custa um crédito por chamada, com o custo variando entre 1 e 6 créditos dependendo do nível de detalhe desejado. O plano gratuito oferece 60 créditos mensais, enquanto os planos pagos podem incluir milhares de créditos e suporte dedicado. Para configurar a conexão, o agente utiliza a URL https://mcp.cnpj.ia.br e autentica com a chave da conta no header Authorization: Bearer.
A busca por empresas pode ser realizada em páginas, com a possibilidade de iterar até encontrar todas as empresas desejadas. O agente precisa decidir entre usar a resposta básica ou completa, dependendo de se deseja informações adicionais como telefone ou email. O procedimento é simples e seguro, permitindo que o agente obtenha as informações necessárias para medir a situação de uma empresa no Brasil.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.
