{
  "markdown": "# @agentum/mcp-server\n\nServidor MCP (Model Context Protocol) que expõe as APIs reais da AGENTUM\n(dados brasileiros e globais: CNPJ, CEP, taxas oficiais, CPF, inteligência\nempresarial, LEI, VAT europeu, câmbio, indicadores econômicos) como\nferramentas que qualquer agente de IA com suporte a MCP (Claude Desktop,\nClaude Code, Cursor, etc.) pode chamar diretamente — pagando por uso, em\nUSDC real, via protocolo [x402](https://x402.org).\n\nSem chave de API, sem cadastro, sem assinatura mensal. Cada chamada é um\npagamento on-chain (Base mainnet) na hora, direto do pacote publicado no\nnpm — não precisa clonar este repositório pra usar.\n\n## Quick Start (menos de 5 minutos)\n\nVocê precisa de duas coisas: uma carteira Ethereum dedicada com um pouco\nde **USDC na rede Base** (mainnet, `eip155:8453` — poucos centavos já\nbastam pra testar; o facilitador de pagamento patrocina o gás, só precisa\nde USDC mesmo), e um cliente com suporte a MCP. Escolha o seu:\n\n> ⚠️ **Em toda opção abaixo, a chave fica em texto puro** no arquivo de\n> config ou no comando. Nunca coloque esse arquivo (nem um comando com a\n> chave escrita nele) num repositório git ou num histórico de shell\n> compartilhado/sincronizado — uma chave vazada dá acesso direto à sua\n> carteira, sem precisar do servidor MCP pra nada.\n\n<details>\n<summary><strong>Claude Desktop</strong></summary>\n\nEdite (ou crie) `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentum\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentum/mcp-server\"],\n      \"env\": {\n        \"AGENTUM_MCP_WALLET_KEY\": \"0xSUACHAVEPRIVADAAQUI\"\n      }\n    }\n  }\n}\n```\n\nReinicie o Claude Desktop. Pronto — pergunte algo como \"verifica o CNPJ\n68964713000109\" e o Claude vai chamar a ferramenta sozinho.\n</details>\n\n<details>\n<summary><strong>Claude Code (CLI)</strong></summary>\n\nDigitar a chave direto no comando grava ela em texto puro no seu\n`~/.zsh_history`/`~/.bash_history` (arquivo que muitos setups de dotfiles\nsincronizam ou versionam sem perceber). Use `read -s` — ele não ecoa o que\nvocê digita/cola, e o shell grava no histórico o comando **como digitado**\n(com `$AGENTUM_MCP_WALLET_KEY` literal), não o valor já substituído:\n\n```bash\nread -s -p \"Cole sua chave privada (0x...): \" AGENTUM_MCP_WALLET_KEY && echo\nexport AGENTUM_MCP_WALLET_KEY\nclaude mcp add agentum -e AGENTUM_MCP_WALLET_KEY=$AGENTUM_MCP_WALLET_KEY -- npx -y @agentum/mcp-server\n```\n\n(`-e`/`--env` vem antes do `--`; tudo depois do `--` é passado intacto pro\nservidor.)\n</details>\n\n<details>\n<summary><strong>Cursor</strong></summary>\n\nPrefira `~/.cursor/mcp.json` (vale pra todos os projetos e não fica dentro\nde um repositório git). Só use a versão no projeto (`.cursor/mcp.json`)\nse você **garantir `.cursor/` no `.gitignore` antes do primeiro commit** —\numa vez que a chave entra no histórico do git, remover o arquivo depois\nnão resolve (fica no histórico; precisaria reescrever com `git filter-repo`\nou equivalente).\n\n```json\n{\n  \"mcpServers\": {\n    \"agentum\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentum/mcp-server\"],\n      \"env\": {\n        \"AGENTUM_MCP_WALLET_KEY\": \"0xSUACHAVEPRIVADAAQUI\"\n      }\n    }\n  }\n}\n```\n</details>\n\n**Nunca use uma carteira que também guarda fundos importantes** — use uma\ndedicada, só com o USDC necessário pro uso que você pretende fazer.\n\n### Exemplo real de ponta a ponta\n\nPrompt pro agente: *\"verifica o CNPJ 68964713000109\"*\n\nO agente decide sozinho chamar `verificar_cnpj({ cnpj: \"68964713000109\" })`\n— o servidor assina um pagamento real de $0.02 USDC na Base, a AGENTUM\nprocessa e devolve, e o agente recebe de volta (dado real, de produção):\n\n```json\n{\n  \"cnpj\": \"68.964.713/0001-09\",\n  \"razao_social\": \"AGENTUM LTDA\",\n  \"situacao\": \"ATIVA\",\n  \"data_situacao\": \"03/09/2026\",\n  \"abertura\": \"03/09/2026\",\n  \"natureza_juridica\": \"206-2 - Sociedade Empresária Limitada\",\n  \"uf\": \"SP\",\n  \"municipio\": \"SERTAOZINHO\",\n  \"atividade_principal\": \"Desenvolvimento e licenciamento de programas de computador customizáveis\",\n  \"fonte\": \"receitaws\"\n}\n```\n\nNenhum código de pagamento escrito por você — o servidor cuida do desafio\nx402, da assinatura e da checagem de segurança (ver seção \"Segurança\"\nabaixo) sozinho.\n\n## Ferramentas disponíveis\n\n| Ferramenta | Preço | Descrição |\n|---|---|---|\n| `verificar_cnpj` | $0.02 | Situação cadastral, Simples Nacional, endereço |\n| `taxas_brasil` | $0.01 | Selic, CDI, dólar comercial (Banco Central) |\n| `verificar_cep` | $0.01 | Endereço completo a partir do CEP |\n| `validar_cpf` | $0.01 | Confere dígito verificador (não consulta dado pessoal) |\n| `business_intelligence` | $0.05 | CNPJ completo + sócios + resumo gerado por IA |\n| `fx_rates` | $0.01 | Câmbio oficial (Banco Central Europeu), qualquer par de moedas |\n| `economic_data` | $0.01 | PIB, inflação, desemprego, população (Banco Mundial), qualquer país |\n| `vat_validate` | $0.01 | Validação de VAT europeu em tempo real (VIES, oficial da UE) |\n| `company_enrich` | $0.01 | Identificação global de empresa via LEI (GLEIF), qualquer país |\n| `company_intelligence_br` | $0.02 | CNPJ + compliance (TCU, CNJ, CEIS, CNEP, CVM) — só fatos, sem score |\n| `preflight` | $0.15 | Veredito de contraparte (CNPJ, LEI ou nome) — band clear/flagged/insufficient_data, nunca um score fabricado |\n\n`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.\n\n## Rodando a partir do código-fonte (desenvolvimento)\n\nSe você clonou este repositório em vez de usar o pacote publicado (`npx`),\na configuração aponta pro arquivo local em vez de deixar o `npx` resolver:\n\n```bash\nnpm install\nread -s -p \"Cole sua chave privada (0x...): \" AGENTUM_MCP_WALLET_KEY && echo\nexport AGENTUM_MCP_WALLET_KEY\n```\n\n(`export VAR=0x...` digitado direto fica gravado em texto puro no seu\nhistórico de shell — `read -s` evita isso, ver aviso no Quick Start acima.)\n\n```json\n{\n  \"mcpServers\": {\n    \"agentum\": {\n      \"command\": \"node\",\n      \"args\": [\"/caminho/completo/pra/mcp-server/index.js\"],\n      \"env\": {\n        \"AGENTUM_MCP_WALLET_KEY\": \"0xSUACHAVEPRIVADAAQUI\"\n      }\n    }\n  }\n}\n```\n\n## Segurança\n\nAntes de assinar qualquer pagamento, o servidor confere que a cobrança\ndevolvida pela AGENTUM é **exatamente**: rede Base mainnet, ativo USDC,\ndestinatário a carteira oficial da AGENTUM, e valor dentro do teto\nconhecido daquela rota específica. Qualquer coisa fora disso e a chamada é\nabortada sem assinar nada — mesmo que o servidor da AGENTUM esteja\ncomprometido ou com bug, sua carteira nunca paga a outro destinatário nem\num valor fora do esperado.\n\nSua chave privada nunca sai da sua máquina/processo local — não é enviada\npra AGENTUM nem pra ninguém, só assina localmente as autorizações de\npagamento x402.\n\n## Rodar standalone (debug)\n\n```bash\nnode index.js\n```\n\nFica esperando conexão MCP via stdio (é assim que um client MCP conecta).\n",
  "bytes": 6997,
  "sha": "76ec28df4dcdc48c80118234a8e0755fb46188d1e9abffa96bf2012ee1897cc3",
  "repo_slug": "orionlabsai/agentum-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_orionlabsai_agentum_mcp_server_66d55cec/readme"
}