Agentum Mcp Server

io.github.orionlabsaiPublished by GitHub account orionlabsaiv1.2.5Updated Oct 24, 2026

Dados globais reais (CNPJ, CEP, LEI, VAT, câmbio) via MCP, pagos em USDC por chamada (x402).

VerifiedSTDIODesktop onlyFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

MCP server exposing AGENTUM's Brazilian and global company, address, tax and FX data APIs, paid per call in USDC on Base via x402.

What you can do
  • Look up Brazilian company records: CNPJ status, partners, compliance checks and a counterparty preflight verdict
  • Validate Brazilian postal codes and CPF check digits
  • Retrieve official economic data: Brazilian Selic, CDI and dollar rates, ECB exchange rates, World Bank indicators
  • Validate European VAT numbers and identify companies worldwide by LEI
  • Each call is paid automatically from the user's own wallet, with the server handling the x402 payment challenge and signing
When to use it
Useful when an assistant needs real, production company, address, tax or economic reference data, especially Brazilian CNPJ and CEP lookups or cross-border counterparty checks, and you are willing to pay a few cents per call in USDC instead of holding an API key or subscription.
Requirements
Runs locally over stdio via npx from the npm package @agentum/mcp-server, in a desktop MCP client such as Claude Desktop, Claude Code or Cursor. Needs a dedicated Ethereum wallet with a small USDC balance on Base mainnet, supplied through the AGENTUM_MCP_WALLET_KEY environment variable. No signup or API key.
Before you install
AGENTUM_MCP_WALLET_KEY is a private key stored in plain text in client config or shell history; a leaked key gives direct access to the wallet. Use a dedicated wallet with only the USDC you intend to spend, never one holding other funds. Every tool call spends real USDC on-chain, with per-call prices from about $0.01 to $0.15. Lookups send the queried identifiers to AGENTUM's servers.

Installation

In SourceWeft

  1. Open Agentum Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@agentum/mcp-server

[M8ven Score]

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.

Claude Desktop

Edite (ou crie) ~/Library/Application Support/Claude/claude_desktop_config.json:

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.

Claude Code (CLI)

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:

bash
read -s -p "Cole sua chave privada (0x...): " AGENTUM_MCP_WALLET_KEY && echoexport AGENTUM_MCP_WALLET_KEYclaude 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.)

Cursor

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).

json
{  "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):

json
{  "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.

Ferramentas disponíveis

FerramentaPreçoDescrição
verificar_cnpj$0.02Situação cadastral, Simples Nacional, endereço
taxas_brasil$0.01Selic, CDI, dólar comercial (Banco Central)
verificar_cep$0.01Endereço completo a partir do CEP
validar_cpf$0.01Confere dígito verificador (não consulta dado pessoal)
business_intelligence$0.05CNPJ completo + sócios + resumo gerado por IA
fx_rates$0.01Câmbio oficial (Banco Central Europeu), qualquer par de moedas
economic_data$0.01PIB, inflação, desemprego, população (Banco Mundial), qualquer país
vat_validate$0.01Validação de VAT europeu em tempo real (VIES, oficial da UE)
company_enrich$0.01Identificação global de empresa via LEI (GLEIF), qualquer país
company_intelligence_br$0.02CNPJ + compliance (TCU, CNJ, CEIS, CNEP, CVM) — só fatos, sem score
preflight$0.15Veredito 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:

bash
npm installread -s -p "Cole sua chave privada (0x...): " AGENTUM_MCP_WALLET_KEY && echoexport 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.)

json
{  "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)

bash
node index.js

Fica esperando conexão MCP via stdio (é assim que um client MCP conecta).

Source: README.md at commit 3f09e8e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v1.2.5LatestOct 1, 2026
  2. v1.2.4Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts