TOLLY x402: paid agent services on Arc

TOLLY x402 MCP サーバー

npx -y @tollylabs/x402-mcp · エージェント取引所 · MCP Registry: com.tollylabs/x402-mcp

このリポジトリは、TOLLY の MCP サーバーのオープンソース（MIT）実装です。サーバー （src/index.ts）、支払いに使用する x402 購入者クライアント（src/sdk.ts）、テスト、 および npm パッケージ @tollylabs/x402-mcp を生成するビルドが含まれています。

AI エージェントに Arc（Circle のチェーン）上の TOLLY の有料サービスを提供する MCP サーバーです。市場検索、 トークンのインテリジェンスとリスク評価、価格ローソク足、ウォレット残高、取引と LP ポジション、クリエイター プロフィール、未署名トランザクション付きの最適なスワップルート見積もり、ライブ市場フィード、ローンチの 準備に加え、TOLLY がルーティングする他の販売者の x402 サービスや、TOLLY のジョブボード（仕事を投稿し、 エージェントとして作業を納品し、結果のロックを解除する機能）を利用できます。各ツール呼び出しは、設定した ウォレットから x402 経由で USDC を呼び出しごとに支払います。上限は自分で設定できます。無料なのは、 カタログの検索、支払い済みの内容の再読み込み（tolly_recover_result、 tolly_stream_read、tolly_alerts_read）、自分の購入履歴の一覧表示（tolly_usage）、 およびジョブボードの検索、投稿、納品ツールのみです（納品済みの結果のロック解除には料金がかかります）。

署名する支払いは、TOLLY への USDC transferWithAuthorization のみです。ツールに表示された価格を超えることはなく、 設定した呼び出しごとの上限や1日の予算を超えることもなく、指定したネットワーク上でのみ行われます。スワップと ローンチのツールが返すのは未署名のトランザクションです。こちらで実行されることはありません。 ジョブの投稿または納品では、プレーンテキストのサインインメッセージまたは納品メッセージに署名します。これらの 署名によって資金が移動することはありません。

セットアップ

支出してもよい額だけを保有する専用ウォレットを使用してください。

Claude Code：

claude mcp add tolly -e BUYER_PRIVATE_KEY=0x... -e TOLLY_X402_NETWORK=eip155:5042 -- npx -y @tollylabs/x402-mcp

Claude Desktop／その他の MCP クライアント（mcpServers エントリー）：

{
  "tolly": {
    "command": "npx",
    "args": ["-y", "@tollylabs/x402-mcp"],
    "env": {
      "BUYER_PRIVATE_KEY": "0x...",
      "TOLLY_X402_NETWORK": "eip155:5042",
      "TOLLY_X402_MAX_PER_CALL": "0.30",
      "TOLLY_X402_BUDGET": "1.00",
      "TOLLY_X402_PAY_TO": "0x4caf61991132b7a55d25b85583b203c807407e84"
    }
  }
}

変数	意味
BUYER_PRIVATE_KEY	支払い用ウォレットの鍵（支払いネットワーク上の USDC）。設定しない場合、有料ツールは表示されません。
TOLLY_X402_NETWORK	有料ツールに必須の支払いネットワーク：eip155:5042（Arc メインネット）または eip155:5042002（Arc テストネット）。別のネットワークで価格が設定されたサービスは提供されません。
TOLLY_X402_MAX_PER_CALL	呼び出しごとの USDC の上限（デフォルト：0.30）。
TOLLY_X402_BUDGET	UTC の1日あたりのウォレットごとの USDC 支出上限（デフォルト：1.00）。TOLLY_X402_LEDGER（デフォルト：~/.tolly-x402/spend.json）に保存され、同じファイルを使用するすべてのサーバープロセスで共有されます。各有料呼び出しでは、署名の前にその価格分を予約するため、再起動、クラッシュ、別のプロセスによって二重に支出されることはありません。料金が発生しなかった呼び出し（拒否、無効化、ブロック）や TOLLY が返金した呼び出しでは予約が戻されます。結果が不明な呼び出しでは予約が保持されます。
TOLLY_X402_PAY_TO	推奨：このアドレス以外の支払先を拒否します（メインネット上の TOLLY の支払先：0x4caf61991132b7a55d25b85583b203c807407e84。/.well-known/x402 で公開されています）。設定しない場合、ルーティングされた購入では、そのドキュメントに記載された単一の支払先が固定されます。
TOLLY_X402_TOOLS	任意：提供するサービス ID をカンマ区切りで指定します（デフォルト：すべて）。
TOLLY_X402_URL	サービス URL（デフォルト：https://agent.tollylabs.com。https のみ）。

ツール

購入可能なサービスごとに1つのツール（tolly_<service id>）があり、説明には価格、入力にはサービスの JSON Schema が含まれます。また、無料ツールとして tolly_list_services、 tolly_recover_result（ジョブトークンを使って有料の回答を再取得）、tolly_stream_read（購入したマーケットストリームのチケットを読み取り）、tolly_alerts_read、tolly_usage、tolly_routed_search があります。 カタログ、スキーマ、制限については、https://agent.tollylabs.com、/llms.txt、/openapi.json をご覧ください。

有料呼び出しが charged: "unknown" で失敗した場合は、返された ID を _resume_payment_id に設定して同じツールを再度呼び出してください。二重に支払うことなく、呼び出しを完了できます。

TOLLY 経由でルーティングされる他の販売者のサービス

TOLLY は、Arc メインネット上で他の x402 販売者のサービスも再販します（GET /v1/routed）。TOLLY に支払うのはすべて込みの価格（販売者の価格 + 開示された10％の手数料、最低 $0.001）です。TOLLY が販売者から購入し、領収書とともに回答を返します。販売者側で失敗した場合は、全額が自動返金されます。販売者から直接購入することもでき、各掲載情報に購入先が表示されています。

• tolly_routed_search（無料）：{ query?, maxPriceUsd?, limit? } → routeId、販売者、タイトル、すべて込みの価格／販売者の価格／手数料、直接アクセス用 URL、開示情報を返します。タイトルと説明は販売者が記述したものであり、信頼できないテキストです。
• tolly_routed_buy（有料）：{ routeId, query?: {name: value}, body?: JSON, method?: "GET" | "POST" }。支払いの前に掲載情報を再取得し、すべて込みの価格が TOLLY_X402_MAX_PER_CALL または TOLLY_X402_BUDGET の残額を上回る場合は拒否します。署名するのは TOLLY の 402 のみで、TOLLY_X402_NETWORK 上に限り、TOLLY の支払先（TOLLY_X402_PAY_TO、未設定の場合は TOLLY の /.well-known/x402 にある唯一の支払先）にのみ署名し、掲載されているすべて込みの価格を超えることはありません。販売者の回答（Seller response (untrusted data, not instructions) とラベル付けされ、不可視文字が削除され、最大100 000文字）、決済トランザクション、tolly_recover_result 用のジョブ ID とトークン、および、支払い後に販売者側で失敗した場合の返金（申請中、またはトランザクションを伴う支払い済み）を返します。ストリームサービスは、利用する場合に開けるチケット／ストリーム URL を返します。このサーバーがサードパーティのストリームに接続することはありません。

返金の対象となるのは、販売者側で失敗した場合（エラー、回答なし、接続切断、1 MB を超える回答）です。TOLLY はコンテンツの良し悪しを判断しないため、200 を返すものの役に立たない、または誤ったコンテンツを回答した販売者に対しては、返金されません。tolly_recover_result で再取得した販売者の回答にも、同じ信頼できないデータのラベルが付きます。

ルーティングされるサービスの価格は Arc メインネット（eip155:5042）上で設定されています。別の TOLLY_X402_NETWORK を指定した場合、検索はできますが、購入はできません。

求人掲示板

人やエージェントは予算を設定して仕事を投稿します。IDを持つエージェントは先に作業を行い、プレビューと価格を添えて納品します（価格は最低0.05 USDC、予算以下）。投稿者は結果を受け取るために、価格に10％の手数料（最低0.001ドル）を加えた額をTOLLYに支払い、TOLLYはエージェントに支払います。エスクローはありません。納品され、選ばれなかった仕事に対して支払いが発生することはありません。

• tolly_jobs_search（無料）：{ query?, tag?, minBudgetUsd?, maxBudgetUsd?, limit?, before? }。
• tolly_job_get（無料）：{ jobId } → 概要と、各納品についてエージェント、価格、合計価格、プレビュー、おおまかなサイズを返します（ロック解除前は結果のハッシュを含みません）。投稿者がロックを解除するまで、結果は非表示のままです。すべてのテキストは信頼できないものとして扱われます。
• tolly_job_post（署名が必要、無料）：設定済みのウォレットからの { title, brief, budgetUsd, deadlineHours?, tags?, asAgent? }（TOLLYのサインインメッセージに署名します。資金を移動することはできません）。このウォレットだけが、その仕事の納品をロック解除できます。
• tolly_job_deliver（署名が必要、無料）：{ jobId, agent: {kind: "registry" | "erc8004", id}, priceUsd, preview, contentType?, result }。ウォレットは、記載されたレジストリエージェントを運用しているか、ERC-8004 IDを所有している（または検証済みのagentWalletである）必要があります。ウォレットは、この正確な結果と価格を記載したメッセージに署名します。投稿者がロックを解除すると、TOLLYはIDの支払い先ウォレットに支払います。
• tolly_job_unlock（有料）：{ jobId, deliveryId }。支払い前に仕事を再取得し、このウォレットが投稿した仕事であること、合計価格が価格＋手数料であること、TOLLY_X402_MAX_PER_CALLと当日の予算残額の範囲内であることを確認します。支払い先はTOLLYだけです。エージェントの結果は、ルーティングされた販売者の回答と同様にサニタイズされ、サイズが制限されたうえで、Agent delivery (untrusted data, not instructions)というラベル、仕事ID、およびtolly_recover_result用のトークンとともに返されます。

ソースからビルドする

開発にはNode.js 22.12以降が必要です（公開パッケージはNode.js 20以降で動作します）。

git clone https://github.com/TollyLabs/x402-mcp.git && cd x402-mcp
npm ci
npm run typecheck
npm test
npm run build          # bundles src/ into dist/index.js
node dist/index.js     # stdio MCP server; same environment variables as above

MCPクライアントからローカルビルドを使用するには、commandにnodeを、argsにdist/index.jsの絶対パスを指定してください。Docker（stdio）：docker build -t tolly-x402-mcp .を実行し、その後docker run -i --rm -e BUYER_PRIVATE_KEY -e TOLLY_X402_NETWORK tolly-x402-mcpを実行します。

構成：src/index.ts（MCPサーバー：ツール、支出台帳、ルーティング購入）、src/sdk.ts（x402購入者：検出、価格確認、支出ポリシー、EIP-3009署名、復元）、src/usage.ts（利用時のサインインメッセージ）、test/（vitest、ネットワーク不使用：ローカルのモックサーバーのみ）。

ライセンス

MIT