AGENTUM MCP Server
This MCP server lets AI agents access real Brazilian/global business and economic data through paid, pay-per-use tools (USDC on Base) with no API key or subscription.
Verify Brazilian CNPJ: check registration status, Simples Nacional, address, and activity.
Get official Brazilian rates: Selic, CDI, commercial USD.
Verify Brazilian CEP: look up full address from a postal code.
Validate CPF: check the mathematical validity of the check digits (no personal data lookup).
Business intelligence: full CNPJ details including partners (CPF masked) and an AI-generated summary.
(From README, beyond schema) Additional tools include FX rates, global economic indicators, EU VAT validation, global LEI company enrichment, CNPJ compliance checks, and counterparty preflight verdicts.
Payments are handled automatically via x402: the server signs real USDC payments on Base mainnet and validates each charge before signing.
Enables pay-per-call access to the AGENTUM data APIs by signing x402 payment authorizations on-chain from a local Ethereum wallet — each tool call settles a real USDC payment on Base mainnet (eip155:8453), with the payment facilitator sponsoring gas. The server validates the returned charge (chain, asset, recipient, and per-route amount cap) before signing, and the private key never leaves the local machine.
@agentum/mcp-server
Servidor MCP (Model Context Protocol) que expõe as APIs reais da AGENTUM (dados brasileiros e globais: CNPJ, CEP, taxas oficiais, CPF, inteligência empresarial, LEI, VAT europeu, câmbio, indicadores econômicos) como ferramentas que qualquer agente de IA com suporte a MCP (Claude Desktop, Claude Code, Cursor, etc.) pode chamar diretamente — pagando por uso, em USDC real, via protocolo x402.
Sem chave de API, sem cadastro, sem assinatura mensal. Cada chamada é um pagamento on-chain (Base mainnet) na hora, direto do pacote publicado no npm — não precisa clonar este repositório pra usar.
Quick Start (menos de 5 minutos)
Você precisa de duas coisas: uma carteira Ethereum dedicada com um pouco
de USDC na rede Base (mainnet, eip155:8453 — poucos centavos já
bastam pra testar; o facilitador de pagamento patrocina o gás, só precisa
de USDC mesmo), e um cliente com suporte a MCP. Escolha o seu:
⚠️ Em toda opção abaixo, a chave fica em texto puro no arquivo de config ou no comando. Nunca coloque esse arquivo (nem um comando com a chave escrita nele) num repositório git ou num histórico de shell compartilhado/sincronizado — uma chave vazada dá acesso direto à sua carteira, sem precisar do servidor MCP pra nada.
Edite (ou crie) ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"agentum": {
"command": "npx",
"args": ["-y", "@agentum/mcp-server"],
"env": {
"AGENTUM_MCP_WALLET_KEY": "0xSUACHAVEPRIVADAAQUI"
}
}
}
}Reinicie o Claude Desktop. Pronto — pergunte algo como "verifica o CNPJ 68964713000109" e o Claude vai chamar a ferramenta sozinho.
Digitar a chave direto no comando grava ela em texto puro no seu
~/.zsh_history/~/.bash_history (arquivo que muitos setups de dotfiles
sincronizam ou versionam sem perceber). Use read -s — ele não ecoa o que
você digita/cola, e o shell grava no histórico o comando como digitado
(com $AGENTUM_MCP_WALLET_KEY literal), não o valor já substituído:
read -s -p "Cole sua chave privada (0x...): " AGENTUM_MCP_WALLET_KEY && echo
export AGENTUM_MCP_WALLET_KEY
claude mcp add agentum -e AGENTUM_MCP_WALLET_KEY=$AGENTUM_MCP_WALLET_KEY -- npx -y @agentum/mcp-server(-e/--env vem antes do --; tudo depois do -- é passado intacto pro
servidor.)
Prefira ~/.cursor/mcp.json (vale pra todos os projetos e não fica dentro
de um repositório git). Só use a versão no projeto (.cursor/mcp.json)
se você garantir .cursor/ no .gitignore antes do primeiro commit —
uma vez que a chave entra no histórico do git, remover o arquivo depois
não resolve (fica no histórico; precisaria reescrever com git filter-repo
ou equivalente).
{
"mcpServers": {
"agentum": {
"command": "npx",
"args": ["-y", "@agentum/mcp-server"],
"env": {
"AGENTUM_MCP_WALLET_KEY": "0xSUACHAVEPRIVADAAQUI"
}
}
}
}Nunca use uma carteira que também guarda fundos importantes — use uma dedicada, só com o USDC necessário pro uso que você pretende fazer.
Exemplo real de ponta a ponta
Prompt pro agente: "verifica o CNPJ 68964713000109"
O agente decide sozinho chamar verificar_cnpj({ cnpj: "68964713000109" })
— o servidor assina um pagamento real de $0.02 USDC na Base, a AGENTUM
processa e devolve, e o agente recebe de volta (dado real, de produção):
{
"cnpj": "68.964.713/0001-09",
"razao_social": "AGENTUM LTDA",
"situacao": "ATIVA",
"data_situacao": "03/09/2026",
"abertura": "03/09/2026",
"natureza_juridica": "206-2 - Sociedade Empresária Limitada",
"uf": "SP",
"municipio": "SERTAOZINHO",
"atividade_principal": "Desenvolvimento e licenciamento de programas de computador customizáveis",
"fonte": "receitaws"
}Nenhum código de pagamento escrito por você — o servidor cuida do desafio x402, da assinatura e da checagem de segurança (ver seção "Segurança" abaixo) sozinho.
Related MCP server: veradata
Ferramentas disponíveis
Ferramenta | Preço | Descrição |
| $0.02 | Situação cadastral, Simples Nacional, endereço |
| $0.01 | Selic, CDI, dólar comercial (Banco Central) |
| $0.01 | Endereço completo a partir do CEP |
| $0.01 | Confere dígito verificador (não consulta dado pessoal) |
| $0.05 | CNPJ completo + sócios + resumo gerado por IA |
| $0.01 | Câmbio oficial (Banco Central Europeu), qualquer par de moedas |
| $0.01 | PIB, inflação, desemprego, população (Banco Mundial), qualquer país |
| $0.01 | Validação de VAT europeu em tempo real (VIES, oficial da UE) |
| $0.01 | Identificação global de empresa via LEI (GLEIF), qualquer país |
| $0.02 | CNPJ + compliance (TCU, CNJ, CEIS, CNEP, CVM) — só fatos, sem score |
| $0.15 | Veredito de contraparte (CNPJ, LEI ou nome) — band clear/flagged/insufficient_data, nunca um score fabricado |
company_intelligence_br e preflight usam uma carteira de destino diferente das outras (sistema AGENTUM Business, processo/domínio separados de propósito) — o servidor já sabe disso e valida cada rota contra a carteira certa dela.
Rodando a partir do código-fonte (desenvolvimento)
Se você clonou este repositório em vez de usar o pacote publicado (npx),
a configuração aponta pro arquivo local em vez de deixar o npx resolver:
npm install
read -s -p "Cole sua chave privada (0x...): " AGENTUM_MCP_WALLET_KEY && echo
export AGENTUM_MCP_WALLET_KEY(export VAR=0x... digitado direto fica gravado em texto puro no seu
histórico de shell — read -s evita isso, ver aviso no Quick Start acima.)
{
"mcpServers": {
"agentum": {
"command": "node",
"args": ["/caminho/completo/pra/mcp-server/index.js"],
"env": {
"AGENTUM_MCP_WALLET_KEY": "0xSUACHAVEPRIVADAAQUI"
}
}
}
}Segurança
Antes de assinar qualquer pagamento, o servidor confere que a cobrança devolvida pela AGENTUM é exatamente: rede Base mainnet, ativo USDC, destinatário a carteira oficial da AGENTUM, e valor dentro do teto conhecido daquela rota específica. Qualquer coisa fora disso e a chamada é abortada sem assinar nada — mesmo que o servidor da AGENTUM esteja comprometido ou com bug, sua carteira nunca paga a outro destinatário nem um valor fora do esperado.
Sua chave privada nunca sai da sua máquina/processo local — não é enviada pra AGENTUM nem pra ninguém, só assina localmente as autorizações de pagamento x402.
Rodar standalone (debug)
node index.jsFica esperando conexão MCP via stdio (é assim que um client MCP conecta).
Available Tools
5 toolsbusiness_intelligenceInteligência empresarial (CNPJ completo)B
Inteligência empresarial brasileira completa: situação cadastral, endereço, atividades, sócios (CPF sempre mascarado pela própria Receita Federal) e resumo gerado por IA a partir só de dados oficiais. Pagamento real de $0.05 em USDC (Base mainnet).
Inputs: cnpj (required).
taxas_brasilTaxas oficiais do BrasilA
Consulta taxas oficiais brasileiras em tempo real (Selic, CDI, dólar comercial). Pagamento real de $0.01 em USDC (Base mainnet).
Inputs: no named parameters.
validar_cpfValidar CPFA
Confirma se um CPF brasileiro é matematicamente válido (dígito verificador) — não consulta dado pessoal de ninguém. Pagamento real de $0.01 em USDC (Base mainnet).
Inputs: cpf (required).
verificar_cepVerificar CEPA
Valida um CEP/endereço brasileiro em tempo real. Pagamento real de $0.01 em USDC (Base mainnet).
Inputs: cep (required).
verificar_cnpjVerificar CNPJA
Verifica um CNPJ brasileiro em tempo real (situação cadastral, Simples Nacional, endereço). Pagamento real de $0.02 em USDC (Base mainnet).
Inputs: cnpj (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
The tools verificar_cnpj and business_intelligence have significant overlap, as business_intelligence includes CNPJ cadastral status, address, and activities, making it a superset of verificar_cnpj. The other tools (taxas_brasil, verificar_cep, validar_cpf) are clearly distinct, but the ambiguity between these two CNPJ-related tools could lead to misselection.
Naming is inconsistent across language and pattern: three tools use Portuguese verbs (verificar_cnpj, verificar_cep, validar_cpf), one uses a Portuguese noun phrase (taxas_brasil), and one uses English (business_intelligence). This mix of languages and grammatical forms breaks any predictable pattern.
With only 5 tools, the server is well-scoped for its purpose of providing Brazilian business and tax data lookups. Each tool covers a distinct data domain (CNPJ, CEP, CPF, taxes, and a comprehensive business report), and none feel superfluous or missing to the point of underutilization.
The tool surface covers the core Brazilian identifiers (CNPJ, CPF, CEP) and financial rates, plus an aggregated business intelligence tool. A minor gap is that verificar_cnpj seems redundant with business_intelligence, and there is no tool for other entity types (e.g., IE – state registration), but the primary use cases are well covered.
Maintenance
Related MCP Connectors
Brazil PTAX, CNPJ/KYB, CEIS-CNEP sanctions, PIX and boleto. Paid x402 MCP API (USDC on Base).
Brazil CNPJ, CEP, Selic/IPCA/PTAX, holidays, banks/ISPB for agents. Pay per call in USDC (x402).
Brazil CNPJ KYB dossier, IBGE CEP lookup, CPF/CNPJ validator & PIX EMVCo CRC16 via x402 Base USDC.
Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceValida CPFs, confirma titularidade, descobre CPF completo a partir de dígitos parciais e resolve CAPTCHA automaticamente, integrando com agentes AI via MCP.22MIT
- FlicenseAqualityBmaintenanceMCP server providing verified Latin American data via x402 micropayments. 4 MCP tools: vera_rates (central bank rates CO/MX/BR/CL/PE), vera_sanctions (OFAC+SARLAFT+CNBV+COAF+UAF screening, EU AI Act Art.13), vera_entity (RUES/CNPJ/RFC enrichment), vera_context (AI market intelligence). $0.02–$0.10 USDC per call.4-
- AlicenseAqualityDmaintenanceAn MCP server for Brazilian company and public procurement data, enabling CNPJ lookup, company search, tender resolution, and more via paid USDC-based API calls.1570 npmMIT
- AlicenseNot gradedqualityCmaintenanceMCP server providing 10 pay-per-call APIs for web scraping, DNS, email validation, and French business data, with autonomous micropayments via the x402 protocol (USDC on Base).MIT