Agents Trust

Agents Trust MCP

Claude Desktop、Cursor、または Claude Code から、タスクに必要な API を検索できます。おすすめには、URL、価格、呼び出しの詳細が含まれます。inspect は、指定したエンドポイント URL 1 件について保存済みの証拠を返します。この stdio サーバーはコンピューター上で動作します。有料の呼び出しにはご自身のウォレットを使用します。Agents Trust がウォレットキーを保持することはありません。

実行には Node.js 20 以降が必要です。npm からインストールすると、MCP ホストが標準入出力経由で起動します。

npx -y @agents-trust/mcp

ウォレットを指定するのはランチャーの実行時のみです（Configuration を参照）。ソースからビルドする場合は、Development を参照してください。

ツールと料金

ツール	入力	結果	料金
recommend	need；limit、live、max_price_usd、chain、view は任意	タスクに使える API と呼び出しの詳細	無料デモ以外では 0.01 USDC
inspect	url；view は任意	プロバイダーを呼び出さずに、保存済みのエンドポイント証拠を返します	エンドポイントの最安提示価格の 1％、最低 0.001 USDC
receipt	payment_attempt_id	後日確定する決済結果	無料
health	なし	サービスのバージョン	無料

おすすめに含まれる正確なエンドポイント URL を指定して inspect を呼び出すよう、ホストに依頼してください。固定のクエリパラメーターはそのまま保持してください。inspect の view には legacy、compact、evidence、debug を指定できます。recommend では legacy、compact、evidence を指定できます。省略すると、API の従来形式のレスポンスが使われます。不明な URL の場合、支払いなしで 404 が返されます。API は、支払いの前に、不正な形式の URL、認証情報を含む URL、プライベート URL を拒否します。inspect がプロバイダーのサービスを呼び出したり購入したりすることはありません。

recommend の入力：need は 2～300 文字で、少なくとも 2 文字の英字または数字を含める必要があります。limit は 1～5 です。live に 1 を指定すると、最近検証されたエンドポイントが優先されます。chain は eip155:8453 のような CAIP-2 ネットワークです。max_price_usd は 0 以上の数値です。receipt には、有料の回答とともに返された payment_attempt_id（UUID バージョン 7）を指定します。

例：{"need":"weather","view":"compact"} を指定して recommend を呼び出すよう、ホストに依頼します。無料デモの内容は変更される場合があります。max_price_usd はおすすめされたプロバイダーの価格を制限しますが、おすすめの手数料は制限しません。おすすめされた API の呼び出しには、別途購入が必要です。

有料の回答には、利用可能な場合、payment_attempt_id が含まれます。決済の確定状況を確認するには receipt を使用してください。回答を受け取っても、決済の確定を意味するものではありません。保留中のレシートは、無料で再度照会できます。

設定

環境変数	デフォルト	用途
AGENTS_TRUST_ENABLE_PAYMENTS	unset / disabled	オーナーによる明示的な有効化：正確に true を指定すると、サーバープロセスごとに最大1回の支払い認可が付与されます
AGENTS_TRUST_WALLET_PRIVATE_KEY	unset	EVM 秘密鍵。0x プレフィックスが必要です。有料の呼び出しに必要です
AGENTS_TRUST_MAX_CALL_USDC	0.01	Recommend または Inspect の1回の呼び出しに対する最大手数料（USDC）
AGENTS_TRUST_SESSION_CAP_USDC	0.01	1つのサーバープロセスで確保できる最大支出額

ウォレットキーが設定されていても、支払いは無効のままです。ウォレットのオーナーは、ローカルランチャーで AGENTS_TRUST_ENABLE_PAYMENTS=true を明示的に指定するか、バンドルの支払い有効化を選択できます。これにより、金額上限の範囲内でプロセスに1回の認可が付与されます。呼び出しごとの人間による確認はありません。エージェントのツール引数、サービスの応答、プロバイダーの指示によって支払い権限が付与されることはありません。Base mainnet に USDC を入れた、残高の少ない専用ウォレットを使用してください。サーバーは x402 認可にローカルで署名し、https://api.agents-trust.com にのみ送信します。公開されている Base USDC アセットと Agents Trust の支払いアドレスを受け付けます。アドレスが変更された場合は、サーバーの更新が必要です。それ以外の支払いネットワークには対応していません。

上限には、小数点以下6桁までの非負の小数文字列を指定できます。ゼロを指定すると有料の呼び出しが無効になります。確保額には、失敗したリクエストや結果が不確かなリクエストを含む署名の試行が計上され、プロセスの終了まで確保されたままになります。署名やリクエストが失敗した場合でも、署名の前にプロセスが唯一の認可を消費します。金額上限を引き上げても、2回目の認可は可能になりません。無料の呼び出しとレシートは引き続き利用できます。サーバーを再起動すると、セッション上限と認可の付与がリセットされます。ウォレットのオーナーが以前の試行を確認するまで、支払い有効化を指定した状態でホストが自動再起動しないようにしてください。Recommend と Inspect は、同じ認可、確保額の上限、直列化された支払いキューを共有します。これには並行した呼び出しも含まれます。有料の送信が自動で再試行されることはありません。結果が不確かな場合は、次の有料呼び出しを行う前にウォレットとレシートを確認してください。

キーがなくても、無料ツールと無料のデモ用レコメンドは利用できます。有料の Recommend または Inspect リクエストは、設定する変数を説明するメッセージを返します。キーをチャット、バージョン管理、シェル履歴に残さないでください。ローカルのシークレットマネージャーまたはホストから、子プロセスにウォレット変数を渡してください。

Claude Desktop

これを claude_desktop_config.json に統合します。無料の設定ではキーは不要です：

{
  "mcpServers": {
    "agents-trust": {
      "command": "npx",
      "args": ["-y", "@agents-trust/mcp"],
      "env": {
        "AGENTS_TRUST_MAX_CALL_USDC": "0.01",
        "AGENTS_TRUST_SESSION_CAP_USDC": "0.01"
      }
    }
  }
}

有料の呼び出しを行うには、AGENTS_TRUST_ENABLE_PAYMENTS=true を明示的に付与し、安全なローカルランチャーを通じて AGENTS_TRUST_WALLET_PRIVATE_KEY をこのプロセスに渡してください。GUI アプリケーションには Node 実行ファイルのフルパスが必要です。また、ターミナルの環境変数を常に継承するとは限りません。

Cursor

~/.cursor/mcp.json または .cursor/mcp.json で同じ mcpServers ブロックを使用し、サーバーエントリに "type": "stdio" を追加します（Cursor の設定）。Cursor の環境にすでに注入されているキーを読み込むには、サーバーの env オブジェクトに次のエントリを追加します：

"AGENTS_TRUST_WALLET_PRIVATE_KEY": "${env:AGENTS_TRUST_WALLET_PRIVATE_KEY}"

ウォレットの設定はローカルに保管し、コミットしないでください。

Claude Code

claude mcp add --transport stdio agents-trust -- npx -y @agents-trust/mcp

Claude Code MCP の設定を参照してください。ウォレットのオーナーが支払い有効化を選択し、シークレットマネージャーからウォレット変数が渡される状態で Claude Code を起動してください。サーバーはホストからその変数を継承します。

開発

AGENTS_TRUST_WALLET_PRIVATE_KEY を設定せずにシェルでソースからビルドしてください。ビルドコマンドとバンドルコマンドは、この変数が空であっても設定されている場合は実行を拒否します。

git clone https://github.com/agents-trust/agents-trust-mcp.git
cd agents-trust-mcp
npm ci
npm run typecheck
npm run lint
npm test
npm run build

node dist/index.js でローカルサーバーを実行します。標準出力には MCP メッセージのみが出力されます。テストではメモリー内で使い捨ての鍵を生成し、支払いは行いません。開発用テストには Node.js 22.13 以降または 24 が必要です。CI では、Node.js 20 上でビルド済みの stdio サーバーも検証します。

npm run test:paid は、生成した使い捨ての鍵とモック HTTP を使用する、オフラインの暗号化認証テストです。いずれのテストも、資金のあるウォレットを読み取ったり、実際の支払いを送信したりしません。依存関係のインストールスクリプトは .npmrc によって無効化されています。レビュー済みのロックファイルを維持するには、npm ci を使用してください。バンドルパッカーもローカルで固定されています。

MIT ライセンスです。LICENSE をご覧ください。