agentum-mcp-server

@agentum/mcp-server

AGENTUM の実際の API（ブラジルおよびグローバルのデータ：CNPJ、CEP、公式金利、CPF、企業情報、LEI、欧州 VAT、為替、経済指標）を、MCP（Model Context Protocol）対応のあらゆる AI エージェント（Claude Desktop、Claude Code、Cursor など）が直接呼び出せるツールとして公開する MCP サーバーです。プロトコル x402 を通じて、実際の USDC で使用量に応じた料金を支払います。

API キー、登録、月額料金は不要です。呼び出しごとに、Base メインネット上で即時にオンチェーン決済されます。公開済みの npm パッケージから直接利用でき、このリポジトリをクローンする必要はありません。

クイックスタート（5 分未満）

必要なものは 2 つです。少額の Base ネットワーク上の USDC（メインネット、eip155:8453。テストには数セントで十分です。決済ファシリテーターがガス代を負担するため、USDC のみ必要です）を入れた専用の Ethereum ウォレットと、MCP 対応のクライアントです。次から選んでください。

⚠️ 以下のすべての方法では、キーは平文のまま保存されます。設定ファイルまたはコマンド内に保存されます。このファイル（またはキーを記述したコマンド）を、Git リポジトリや共有・同期されたシェル履歴に決して入れないでください。キーが漏洩すると、MCP サーバーを介さずにウォレットへ直接アクセスされる可能性があります。

{
  "mcpServers": {
    "agentum": {
      "command": "npx",
      "args": ["-y", "@agentum/mcp-server"],
      "env": {
        "AGENTUM_MCP_WALLET_KEY": "0xSUACHAVEPRIVADAAQUI"
      }
    }
  }
}

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

{
  "mcpServers": {
    "agentum": {
      "command": "npx",
      "args": ["-y", "@agentum/mcp-server"],
      "env": {
        "AGENTUM_MCP_WALLET_KEY": "0xSUACHAVEPRIVADAAQUI"
      }
    }
  }
}

重要な資金を保管しているウォレットは絶対に使用しないでください。専用のウォレットを用意し、利用予定の用途に必要な USDC だけを入れてください。

実際の一連の処理の例

エージェントへのプロンプト：「CNPJ 68964713000109 を確認して」

エージェントは自動的に verificar_cnpj({ cnpj: "68964713000109" }) を呼び出すと判断します。サーバーが Base 上で実際に $0.02 USDC の決済に署名し、AGENTUM が処理して応答します。エージェントには実際の本番データが返されます。

{
  "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"
}

決済コードを自分で書く必要はありません。サーバーが x402 のチャレンジ、署名、安全性チェック（下記の「セキュリティ」セクションを参照）をすべて処理します。

利用可能なツール

company_intelligence_brとpreflightは、他のツールとは異なる送金先ウォレットを使用します（AGENTUM Businessシステムで、プロセス／ドメインを意図的に分離しています）。サーバーはこの違いを把握しており、各ルートを対応する正しいウォレットに照らして検証します。

ソースコードから実行する（開発）

公開パッケージ（npx）ではなく、このリポジトリをクローンした場合は、 npxに解決させず、ローカルファイルを参照するように設定します。

npm install
read -s -p "Cole sua chave privada (0x...): " AGENTUM_MCP_WALLET_KEY && echo
export AGENTUM_MCP_WALLET_KEY

（export VAR=0x...を直接入力すると、シェルの履歴に平文で保存されます。read -sを使えば防げます。上記のQuick Startにある注意事項を参照してください。）

{
  "mcpServers": {
    "agentum": {
      "command": "node",
      "args": ["/caminho/completo/pra/mcp-server/index.js"],
      "env": {
        "AGENTUM_MCP_WALLET_KEY": "0xSUACHAVEPRIVADAAQUI"
      }
    }
  }
}

セキュリティ

支払いに署名する前に、サーバーはAGENTUMから返された請求内容が厳密に以下の条件を満たすことを確認します。ネットワークがBase mainnetであること、資産がUSDCであること、送金先がAGENTUMの公式ウォレットであること、金額がそのルート固有の既知の上限内であることです。これらの条件から外れるものがあれば、署名せずに呼び出しを中止します。AGENTUMのサーバーが侵害されたり、バグがあったりしても、あなたのウォレットが別の送金先や想定外の金額に支払うことはありません。

秘密鍵がローカルのマシン／プロセスから外部に出ることはありません。AGENTUMにも他の誰にも送信されず、x402の支払い認可への署名にローカルでのみ使用されます。

単独で実行する（デバッグ）

node index.js

stdio経由のMCP接続を待ち受けます（MCPクライアントはこの方法で接続します）。