agent-trust-mcp

Agent Trust Oracle MCP

Agent Trust OracleをClaude Desktop、Cursor、または任意の MCP クライアントにツールとして接続できます。エージェントに ERC-8004 のトラストスコアを尋ねると、エージェントがツールを呼び出します。有料ツールでは、x402を通じてブリッジがBase 上の USDCで自動的に支払い、署名済みの結果を返します。

get_trust_previewツールは無料で、ウォレットキーは不要です。有料ツールは呼び出しごとに数セントかかり、Base ウォレットキーを設定した場合にのみ有効になります。

クイックスタート（クローンもビルドも不要）

クライアント設定に以下を追加すれば完了です。npxが取得して実行します。

Claude Desktop — Settings → Developer → Edit Config：

{
  "mcpServers": {
    "agent-trust": {
      "command": "npx",
      "args": ["-y", "@nikosble1926/agent-trust-mcp"]
    }
  }
}

これだけで無料のプレビューを利用できます。有料ツールを有効にするには、残高を少額にした Base ウォレットキーを追加します。

{
  "mcpServers": {
    "agent-trust": {
      "command": "npx",
      "args": ["-y", "@nikosble1926/agent-trust-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x<your-low-balance-base-wallet-private-key>"
      }
    }
  }
}

Cursor — Settings → MCP → Add new server。同じcommand／args／envを設定します。

クライアントを再起動してから、「"Get an agent trust preview"」（無料）または「"Get the trust score for agent 6976 on ethereum"」（有料）と尋ねてください。

ツール

ツール	コスト	説明
get_trust_preview	無料	ERC-8004 エージェントのトラストスコアの例（0～100）と内訳。ウォレットキーは不要です
get_agent_trust	$0.005 USDC	1つのエージェントの署名済み ERC-8004 トラストスコア（0～100）と内訳（クライアントの広がり、直近性、価値、ボリューム）。パラメーター：agent（uint256 ID、例：6976）、chain（base／bsc／ethereum／mantle／polygon、デフォルトはethereum）

有料モード（任意）

有料ツールにはEVM_PRIVATE_KEYが必要です。少量のUSDCを保有する、残高を低く抑えた専用のホットウォレットのBase ウォレット秘密鍵を設定してください。メインのウォレットは絶対に使用しないでください。支払い側のガス代は不要です（ガス代はファシリテーターが負担します）。そのため、必要なのは少額の USDC 残高だけです。キーが設定されていない場合、有料ツールは「set EVM_PRIVATE_KEY」という明確なメッセージを返し、無料のプレビューは引き続き利用できます。

RESOURCE_SERVER_URLは任意で、デフォルトはhttps://trust.nsgoods.orgです。

ソースから実行（開発用）

cd mcp
npm install
npm run build
node dist/server.js   # or: npm run dev

セキュリティ

• EVM_PRIVATE_KEYは購入者であるあなた自身のものであり、クライアント設定内のローカルに保持されます。API に送信されることはありません。少額の USDC 残高のみを保有する、使い捨てのホットウォレットを使用してください。
• 支出を管理するには、x402 の公式 MCP ガイドにあるポリシーチェックフックを参照し、呼び出しごと／セッションごとの金額に上限を設定してください。

メモ

公式の x402 MCP クライアントパターンを踏襲しています： https://docs.x402.org/guides/mcp-server-with-x402 。x402 v2 の TypeScript パッケージ（@x402/axios、@x402/evm）は頻繁に更新されます。npm installやビルドに失敗した場合は、最新のパッケージ名／バージョンをガイドで確認してください。

トラストスコアはオンチェーンの ERC-8004 Identity + Reputation レジストリを読み取ります。有料の/agent-trustと無料の/agent-trust/previewのすべてのレスポンスには、検証用のsigned_by + signatureが含まれます。サービス側にアカウントも API キーも不要です。教育目的の情報であり、金融アドバイスではありません。MIT ライセンス。