Skip to main content
Glama
AGENTUM MCP Server

AGENTUM MCP Server

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

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

verificar_cnpj

$0.02

Situação cadastral, Simples Nacional, endereço

taxas_brasil

$0.01

Selic, CDI, dólar comercial (Banco Central)

verificar_cep

$0.01

Endereço completo a partir do CEP

validar_cpf

$0.01

Confere dígito verificador (não consulta dado pessoal)

business_intelligence

$0.05

CNPJ completo + sócios + resumo gerado por IA

fx_rates

$0.01

Câmbio oficial (Banco Central Europeu), qualquer par de moedas

economic_data

$0.01

PIB, inflação, desemprego, população (Banco Mundial), qualquer país

vat_validate

$0.01

Validação de VAT europeu em tempo real (VIES, oficial da UE)

company_enrich

$0.01

Identificação global de empresa via LEI (GLEIF), qualquer país

company_intelligence_br

$0.02

CNPJ + compliance (TCU, CNJ, CEIS, CNEP, CVM) — só fatos, sem score

preflight

$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.js

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

Available Tools

5 tools
business_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

    A3.6/5.0

    Scored across 5 tools

    Disambiguation2/5

    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 Consistency2/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Valida CPFs, confirma titularidade, descobre CPF completo a partir de dígitos parciais e resolve CAPTCHA automaticamente, integrando com agentes AI via MCP.
      22
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      MCP 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
      -
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for Brazilian company and public procurement data, enabling CNPJ lookup, company search, tender resolution, and more via paid USDC-based API calls.
      15
      70 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP 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