mcpField
A
agenttoll

agenttoll

ローカル
github.com/tevfikefeaydin金融データ0今日更新

agenttoll について

agenttoll は、Base の市場、オンチェーン活動、トークン安全性、ポートフォリオ情報を扱う Agent 向け有料データ API です。無料の見積もり・予算確認も備え、上限付き USDC 決済を Base メインネットで行います。

主な機能

  1. 0121 種類の有料データエンドポイント
  2. 02無料の見積もりと予算確認
  3. 03価格、オンチェーン活動、市場情報の取得
  4. 04トークン安全性と証拠範囲の確認
  5. 05トークン観測記録の保存と比較
  6. 06上限付き USDC 決済

活用シーン

  1. 01新しい流動性プールの発見とトークン評価
  2. 02アドレス活動や観測済み保有資産の確認
  3. 03保存したトークン安全性レポートの比較
  4. 04有料リクエスト前の見積もり確認

MCP 対応

README には MCP パッケージへの言及がありますが、公開するツールやインターフェースの説明はありません。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"tevfikefeaydin-agenttoll": {
"command": "npx",
"args": [
"-y",
"agenttoll-mcp"
],
"env": {
"AGENT_PRIVATE_KEY": "<AGENT_PRIVATE_KEY>",
"AGENTTOLL_URL": "<AGENTTOLL_URL>",
"AGENTTOLL_NETWORK": "<AGENTTOLL_NETWORK>",
"AGENTTOLL_RECIPIENT": "<AGENTTOLL_RECIPIENT>",
"AGENTTOLL_BUDGET_USDC": "<AGENTTOLL_BUDGET_USDC>",
"AGENTTOLL_MAX_PER_CALL_USDC": "<AGENTTOLL_MAX_PER_CALL_USDC>",
"AGENTTOLL_TIMEOUT_MS": "<AGENTTOLL_TIMEOUT_MS>"
}
}
}
}
起動コマンドnpx -y agenttoll-mcp
設定が必要な環境変数
AGENT_PRIVATE_KEYシークレットOptional paying-wallet EVM private key; omit for free quote/budget inspection.
AGENTTOLL_URLAPI origin (default https://agenttoll.app); custom origins require AGENTTOLL_RECIPIENT.
AGENTTOLL_NETWORKPayment network: base (default) or base-sepolia. Base data always uses mainnet.
AGENTTOLL_RECIPIENTTrusted receiving address; required for a custom API origin.
AGENTTOLL_BUDGET_USDCFinite session USDC budget (default 1); maximum six decimal places.
AGENTTOLL_MAX_PER_CALL_USDCOptional lower USDC ceiling; registered endpoint prices remain the upper limit.
AGENTTOLL_TIMEOUT_MSTotal quote/sign/retry/body timeout in milliseconds (default 30000; 1–300000).

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmagenttoll-mcp0.14.0

ツール

23

掲載時のツール一覧 · 3 週間前に更新

このツールにパラメーターはありません。

詳細

AgentToll — AI エージェント向けの従量課金 API

AgentToll

npm Base mainnet x402 MIT x402-listに掲載

agenttoll.app は、エージェント向けの有料データエンドポイントを21個提供しており、価格は0.001~0.008 USDCです。ホスト型サービスの決済はBase mainnetで行われます。オンチェーンIDはagenttoll.base.ethです。ソースコード · MCPパッケージ。

新規プールの検出、トークンの安全性チェック、サンプル取得されたレーダー履歴、ウォレットのアクティビティ、市場データを、1つのAPIで利用できます。Baseの市場データとチェーンデータには常にmainnetを使用します。セルフホストインスタンスでは、データネットワークを変更せずにBase Sepoliaで決済を受け付けられます。

ブラウザーでトークンを確認する

/inspect.html のブラウザーフローには、実際のプロバイダーデータから取得した、日付付きの無料レポートが含まれています。Baseトークンのコントラクトアドレスを貼り付けると、ウォレットを接続せずに価格を確認できます。その後、USDCでの1回の支払いを承認すると、8項目のチェックレポートを受け取れます。既存の /api/base/safety/:address エンドポイント($0.003)を使用し、証拠が不足している場合はそのまま表示します。また、決済レシートとJSONのダウンロードも利用できます。レポートは最長5分間キャッシュできます。署名済みの結果が不明確な場合は、再度支払いを要求する前にウォレットを確認する必要があります。

web/inspect.html はページテンプレート、web/inspect.ts は見積もりと支払いを制御し、web/token-report.ts はデータを表示します。npm run build:web は両方のブラウザーバンドルをビルドし、public/token-example.json を生成されたページに埋め込むため、JavaScriptがなくてもサンプルを利用できます。npm run check:generated は、生成された3つのファイルがそれぞれのソースと一致しているかを確認します。サンプルを更新する場合は、新たに記録したレスポンスと、その取得時刻および由来情報を使用してください。古いサンプルをリアルタイムのものとして表示しないでください。

運用上の確認指標は、エクスポートされたアプリケーションログから取得します。OPERATIONS.mdのops:inspectionsを参照してください。これらの指標では、mainnetでの決済とテストネットのアクティビティ、既知の運営者ウォレットを区別します。また、ウォレットが個人であることや、見積もりがユニークな訪問者を示すことを主張するものではありません。

保存済みの調査、比較、ウォレット保有資産

/research.html では、ブラウザー内に限定されたウォッチリストと日付付きのレポート履歴を管理します。トークンアドレスまたは記録済みのサンプルを保存できます。完了した調査はインスペクターからも保存できます。保存数は、ウォッチ対象のトークンが50件、サニタイズ済みレポートが100件(1トークンあたり10件)に制限されています。キー、署名、支払いレシート、支払い元ウォレットアドレスは保存されません。このデータはこのブラウザーに固有です。サイトデータを削除すると履歴も削除されます。保存に失敗した場合はエラーが表示され、保存済みデータは保持されます。

履歴画面では、同じトークンかつ同じ来歴タイプの観測結果を比較できます。不足している証拠はそのまま保持され、日付が不明な場合や同一の観測結果の内容に食い違いがある場合は警告が表示されます。キャッシュされた結果が繰り返し表示されても、新たな確認結果としては扱われません。サンプルや共有スナップショットは、調査結果とは別に扱われます。

保存済みの観測結果を使って2~5個のトークンアドレスを比較するか、新たな調査の合計見積もりを確認できます。各トークンには既存の安全性確認エンドポイントを使用し、それぞれに対して個別にウォレット認証を行います。バッチは順次実行され、完了したレスポンスとレシートは保持されます。失敗すると処理は停止します。残りのリクエストを実行するには、新しい見積もりを明示的に確認する必要があります。不確定な支払いがある場合は、ウォレットを確認してから別の支払いを開始する必要があります。長時間のバッチで残りの手順がある場合も含め、表示された見積もりの有効期限は60秒です。

ウォレットパネルでは、/api/base/portfolio/:address?minValue=0&limit=50 の料金を個別に見積もり、確認できた保有資産とデータソースの網羅状況を表示します。また、検出されたERC20トークンから最大5件を選び、料金を個別に見積もったうえで調査できます。ネイティブETH、保有していても確認できない、または価格が付いていないトークン、データの網羅性に関する不足は、調査済みとして暗黙に扱われることはありません。ウォレットアドレスとポートフォリオのレスポンスはページのメモリ内に保持されます。

レポートの操作では、サイズを制限したURLフラグメントのスナップショットをコピーするか、1200×1200のPNGカードをダウンロードできます。/shared-report.html では、インポートされたすべてのスナップショットに「ユーザー提供・未検証」と明記し、観測日を保持します。また、自動的に支払いを行ったり、データを保存したりすることはありません。フラグメントの内容はリンクを知っている人なら誰でも閲覧・変更できます。認証済みのAgentToll記録ではありません。支払い情報とウォレットのメタデータは除外されます。バックグラウンドでの監視やメッセージ送信サービスはありません。

web/research*.ts、web/portfolio-model.ts、web/report-share.ts がこれらのツールを実装します。ビルドではCSSソースファイルを共有しつつ、その内容を生成HTMLにインライン化して、既存のデプロイ済みコンテンツセキュリティポリシーに適合させています。npm run build:web はすべてのブラウザーエントリを再生成し、npm run check:generated は生成結果を検証します。

支払いフロー

  1. 署名されていないリクエストに対し、PAYMENT-REQUIRED内にbase64形式のJSON見積もりを含むHTTP 402が返されます。JSONレスポンスには、accepts を読み取るクライアントや検出クローラー向けに、同じ完全な見積もりが本文にも含まれます。
  2. クライアントは、エンドポイントの上限、想定されるオリジン、ネットワーク、USDCコントラクト、受取人を検証し、予算内でEIP-3009認証に署名します。
  3. 再試行リクエストにはPAYMENT-SIGNATUREを含めます。ファシリテーターが支払いを検証し、ハンドラーが正常なレスポンスを返した後に決済します。決済レシートはPAYMENT-RESPONSEに含まれます。

APIの利用者にアカウントやAPIキーは必要ありません。支払いを行うクライアントにはウォレットキーが必要です。運用者にはファシリテーターや上流サービスの認証情報が必要になる場合があります。最初の見積もりと、署名を付けた再試行は別々のHTTPリクエストです。

決済前にハンドラーで失敗した場合、請求は発生しません。署名または決済の後にレスポンスの消失やタイムアウトが起きた場合、結果が不明となることがあります。再試行する前に、レシートとウォレットを確認してください。このクライアントは上限を設け、結果が不明な署名済み金額を予約扱いにして保持します。

エンドポイント

GET エンドポイント説明1 回あたりの USDC
/api/price/:symbol現物の USD 価格と 24 時間の変動$0.001
/api/gas?gasLimit=Base のガス代、最新ブロック、任意のトランザクションコスト見積もり$0.001
/api/trending?limit=市場全体でトレンドとなっている資産$0.002
/api/base/token/:addressオンチェーンの Base トークン価格$0.001
/api/base/address/:addressBase アドレスのスナップショットと、検証済みのプライマリ Basename$0.001
/api/base/portfolio/:address?minValue=&limit=観測された保有資産と、カバレッジ付きの USD 評価額$0.003
/api/base/safety/:address自動トークンチェックと、証拠が不足している項目のカバレッジ$0.003
/api/base/scout?minLiquidity=&pools=安全性の結果を含む、選定されたレーダープール$0.008
/api/base/fresh?minutes=&limit=&fundedOnly=直近の Uniswap v4 プールイベント、トークンの特定、資金調達アクティビティ$0.004
/api/base/radar/history?date=不変の git SHA に固定された公開済みスナップショット$0.002
/api/base/scorecard?days=最新の公開済みサンプルと現在の観測結果との比較$0.005
/api/base/name/:nameOrAddressBasename の順方向解決と、検証済みの逆方向解決$0.001
/api/feargreed?days=任意の日次履歴付きのセンチメント指数$0.001
/api/base/trending?limit=トレンドとなっている Base DEX プール$0.002
/api/brief?symbols=価格、Base のガス代、センチメントをまとめて取得$0.005
/api/base/radar?minLiquidity=&limit=流動性の下限を超える新規プールのランキング一覧$0.003
/api/try/premium?asset=暗号資産から算出した USD/TRY と公式レートとの比較$0.002
/api/try/spread?asset=トルコの取引所の価格と世界の USD 価格との比較$0.002
/api/watch/address/:address?since=ページネーション対応の、確定済みアドレストランザクション$0.002
/api/watch/radar?since=現在の部分的なレーダー一覧からの新しい観測結果$0.003
/api/watch/price/:symbol?ref=&pct=価格しきい値のチェック$0.001
/api/statsネットワーク/受信先ごとのオンチェーン通行料の合計無料
/api/catalog機械可読なエンドポイントカタログ無料
/api/demo静的なレスポンス形式のサンプル無料
/api/healthプロセスの稼働状況無料
/api/readyFacilitator と Base RPC の準備状況無料

任意のクエリパラメーターによって登録済みの料金が変わることはありません。無効な入力には 400 を返します。fundedOnly が受け付けるのは、文字列としての true または false です。パラメーターの制限については、カタログと OpenAPI に記載されています。選択された上流の結果はキャッシュされ、同時に発生した読み込みは集約されます。TTL は結果によって異なり、履歴キャッシュはライブ市場キャッシュより長く保持されます。

API の GET/HEAD リクエストでは URL パラメーターと支払いヘッダーを使用し、リクエストボディがある場合は 400 を返して接続を閉じます。エンコードされたパスパラメーター、大文字・小文字の違い、末尾のスラッシュ 1 つはサポートされています。エンコードされたルートプレフィックス、および重複するパス区切り文字やエンコードされたパス区切り文字は、支払い検証の前に拒否されます。

データの解釈

安全性レスポンスでは、不明なチェック項目とプロバイダーのカバレッジがそのまま保持されます。オーナー権限のフラグや税率が欠落していても、問題なしとは判断できません。clear とするには必要な証拠が揃っている必要があります。他のチェック項目が不明でも、検出された失敗によって高リスクと判定されることがあります。自動チェックに合格しても、安全性が保証されるわけではありません。ポートフォリオとレーダーのレスポンスも、部分的な結果やカバレッジを示すフィールドを正しく解釈する必要があります。

無料の補足的な安全性情報源では、アドレスのリスクスクリーニング、確認済みのインターフェース情報、観測されたプールの流動性を提供します。インターフェース名や時価総額があっても、不足している権限チェックや流動性の所有者チェックを補うことはできません。安全性の証拠と制限を参照してください。

ポートフォリオのインデクサーによるスキャンは、3ページ読み込んだ時点、またはインデックス済みの末尾が$1のソース読み取り下限を下回った時点で終了します。minValueを下げると表示フィルターが変わりますが、このソーススキャンの上限は変わりません。未読のプロバイダーページがある場合、レスポンスは部分的であると示されます。合計と価格未設定数は、観測された保有資産のみを示し、未観測のトークン数は不明です。センチメントのレスポンスでは、キャッシュから提供される場合も含め、プロバイダーによる観測時刻と取得時刻が別々に保持されます。

アドレスから Basename への変換結果は、元のアドレスに対して逆引きされます。最新のプール情報は Uniswap v4 を対象とします。トークンの帰属先が null になる場合があります。経過時間はブロック高に基づく推定値であり、funded は流動性イベントを観測した記録であって、USD建ての流動性評価ではありません。

ウォレットとレーダーの監視

/api/watch/address/:address では、不透明なカーソルを変更せずに保持し、since として渡してください。スケジュールされたポーリングを再開する前に、hasMore が true の間は続けて呼び出してください。各呼び出しで読み取るプロバイダーページは1つです。partial と coverage.complete は、そのスキャンが完了したかどうかを示します。最初のカーソルには ISO タイムスタンプも使用できます。

ポーリングの重複期間は120秒で、記憶されるトランザクションハッシュは最大100件です。特に coverage.replayPossible が true の場合は、利用側のエージェントでハッシュを使って重複を排除してください。これらの上限は、インデックス作成の遅延、過去のリオーガナイズ、インデクサーの欠落をすべて網羅するものではありません。

レーダーの監視では、ランキング順で流動性フィルターが適用された一覧に対する ISO カーソルを使用します。カバレッジは常に部分的です。一覧から漏れたプールや、インデックス作成が遅れたプールを見逃す可能性があります。価格アラートの監視ではしきい値の結果が報告され、カーソルはありません。

公開済みの履歴とスコアカード

スナップショットのワークフローでは、選択された scout の観測結果がdata/scout/に書き込まれ、git で公開されます。履歴の読み取りでは、インデックスとスナップショットのバイト列が同一の不変リビジョンに固定され、provenance.revision と commit/raw のリンクで確認できます。支払いトランザクションは決済記録であり、スナップショットの内容を認証したり、取得時刻を証明したりするものではありません。

スコアカードでは、days は厳密な暦日での遡及期間ではなく、公開済みスナップショットの最新N日分を選択します。トークンについては、選択された期間内で最初に観測された時点を使用するため、保有期間は異なります。カバレッジには、欠落しているスナップショット、評価されていないプール、利用できない価格見積もりが報告されます。利用できない場合、価格変動と結果は null のままです。liquidityGone=true は、選択したプロバイダーペアで観測された流動性が$100未満であることを意味し、すべての流動性が消失した証明ではありません。中央値の計算には、価格が設定された観測値のみを使用します。これらの選択されたサンプルは、Base でのトークンローンチを網羅した記録ではありません。

レスポンス、エラー、準備状況

成功したデータレスポンスには、meta.requestId、servedAt、observedAt、ageSeconds、dataNetwork、paymentNetwork が含まれます。取得できない観測タイムスタンプと経過時間は null のままです。HTTP の X-Request-Id ヘッダーはリクエストを識別します。

構造化された API エラーには、error、code、retryable、retryAfter、requestId が含まれます。一般的なステータスは、入力が無効な場合は 400、リクエストボディが大きすぎる場合は 413、レート制限の場合は 429、アップストリームが利用できない場合は 502、期限切れの場合は 504 です。決済の結果が不明な決済試行では、paymentOutcome: "unknown" と retryable: false が報告されます。Retry-After が指定されている場合はそれに従い、結果が不明な署名済み決済を自動的に再試行しないでください。

無料の /api/health エンドポイントは稼働状態を報告します。/api/ready は、制限時間付きのプローブでファシリテーターのサポートと Base RPC を確認し、その結果を 15 秒間キャッシュします。準備が整っていない場合は 503 を返します。準備完了は、すべてのデータプロバイダーが利用可能であることを保証するものではありません。

独自のサーバーを実行する

ホスト型サービスは、Docker/Caddy を使用して Hetzner 上で稼働しています。main にプッシュされたコードは、GitHub CI の成功後、候補が API とプロキシのチェックに合格すると自動的にデプロイされます。自動デプロイ手順書と移行検証記録をご覧ください。

Node.js 22 以降が必要です。

git clone https://github.com/tevfikefeaydin/agenttoll
cd agenttoll
npm install
cp .env.example .env
# Replace ADDRESS with your public receiving wallet address.
npm run dev

デフォルトでは http://localhost:4021 で、Base Sepolia の支払いを使用します。ADDRESS は必須です。プレースホルダーのままにするか、ゼロまたは不正なアドレスを設定すると、起動に失敗します。サーバーの ADDRESS に本番用ウォレットキーを使用しないでください。ADDRESS は公開された受取先であり、秘密鍵ではありません。

設定意味
ADDRESS必須の、ゼロではない公開受取アドレス
NETWORKbase-sepolia(デフォルト)または base。決済のみを制御します
PUBLIC_URL検出用の公開サービス URL。ローカルではデフォルトで http://localhost:PORT になり、Vercel 上では Vercel のホストが使用されます
PORTローカルポート。デフォルトは 4021 です
REQUEST_TIMEOUT_MSリクエスト全体の期限。デフォルトは 25000 です。設定可能な範囲は 100~120000 です
PAUSED_ENDPOINTSオプションの、カンマ区切りのカタログパス。支払い前に 503 を返し、カタログでは available:false としてマークされ、アクティブな検出対象から除外されます。定期的なウォームアップでは一時停止中のルートをスキップしますが、手動の修復処理は復旧するまで失敗します。
TRUST_PROXYfalse、信頼するホップ数(1~5)、または明示的な IP/CIDR エントリ。ローカルではデフォルトで false、Vercel では 1 ホップです
FACILITATOR_URLデフォルトは https://x402.org/facilitator です。メインネットでのデフォルトでは CDP が選択されます
CDP_API_KEY_ID / CDP_API_KEY_SECRETデフォルトのメインネット CDP ファシリテーターを使用する場合、両方が必要です
BLOCKSCOUT_API_KEYオプションの上流クォータ認証情報
ADDRESS_ACTIVITY_PROVIDERアドレスアクティビティのみ:blockscout(デフォルト)または ankr。Ankr は、値がゼロの呼び出しや失敗したトランザクションも含む、Base のインデックス済みトランザクション API を使用します。
ANKR_API_KEYAnkr のアドレスアクティビティに必要です。プライベートなランタイム設定に保存し、実際のトークンをコミットしないでください。

Ankr のアドレス監視カーソルは不透明で、プロバイダーに紐付いています。既存の Blockscout カーソルを Ankr で使用すると、最近の重複排除を維持しつつ、元の時間範囲の先頭から再開します。coverage.replayPossible は、移行によって古いトランザクションが再生される可能性があることを警告します。hasMore のページを最後まで取得し、トランザクションハッシュで重複を排除してください。各呼び出しで読み取られるインデックス済みの確定済みトランザクションは最大 50 件です。このフィードには、保留中のトランザクション、内部呼び出し、トークン転送ログは含まれません。Base へのアクセスとページネーションを確認してからプロバイダーを有効にし、その後、アドレス監視ルートを PAUSED_ENDPOINTS から削除してください。

localhost 以外では、URL 設定に HTTPS が必要です。実際のデプロイ先に合わせて PUBLIC_URL と TRUST_PROXY を設定してください。インスタンスごとのレート制限は、1 IP あたり毎分、無料の API/検出リクエストが 60 件、有料ルートへのリクエストが 600 件です。署名なしの見積もりと署名付きの再試行はどちらもカウントされます。複数インスタンスで共有されるレート制限ではありません。

署名なしで有料エンドポイントを呼び出すと、見積もりのみを確認します。

curl -i http://localhost:4021/api/price/eth
# HTTP/1.1 402 Payment Required
# PAYMENT-REQUIRED: <base64 x402 v2 quote>

ブラウザのデモは、同一オリジンのエージェントカードからセルフホストされた受取先とネットワークを読み取り、表示された見積もりを検証して、その条件に限って署名します。Base と Base Sepolia に対応し、注入されたウォレットの RPC を使用します。

上限付き有料クライアント

src/pay.ts は payingFetch(privateKey, network, options?) を公開します。クライアントインスタンスごとに、デフォルトで有限の予算 1 USDC と合計期限 30000 ms が設定されます。見積額は登録済みエンドポイントの価格を超えられません。オプションの maxPerCallUsdc で、この上限を引き下げることができます。予算の確認と予約は、並行する呼び出し間でアトミックに行われます。

import { payingFetch } from "./src/pay.js";

const key = process.env.AGENT_PRIVATE_KEY;
if (!key) throw new Error("AGENT_PRIVATE_KEY is required");
const client = payingFetch(key, "base", {
  baseUrl: "https://agenttoll.app",
  totalBudgetUsdc: "1",
  maxPerCallUsdc: "0.008",
  timeoutMs: 30_000,
});
console.log(await client.getPaymentQuote("/api/price/eth")); // no payment
const response = await client.fetchWithPayment("/api/price/eth");
console.log(await response.json());
console.log(client.getPaymentBudget());

上記の署名済みリクエストを実行すると、成功した場合に実際のメインネット USDC が消費されます。getPaymentBudget は、合計額、消費額、予約額、残額を報告します。署名済みリクエストの失敗時、またはタイムアウト/キャンセル時に署名が保留中の場合、予約は保持されます。予算はクライアントインスタンスごとにリセットされ、以前の承認は取り消されません。呼び出し元の AbortSignals は尊重されます。リダイレクトと未登録のルートは拒否されます。

カスタムオリジンを使用する場合は、baseUrl と明示的に信頼する受取人を指定してください。2 つの TypeScript の例はデフォルトで localhost を使用し、その場合はサーバーの公開 ADDRESS を再利用できます。リモートホストでは ADDRESS を再利用しません。AGENTTOLL_NETWORK が優先されます。localhost では、それ以外の場合は NETWORK(デフォルトは base-sepolia)に従います。リモートの例/スクリプトではデフォルトで base を使用します。

例と有料スクリプトでは、AGENTTOLL_BUDGET_USDC、AGENTTOLL_MAX_PER_CALL_USDC、AGENTTOLL_TIMEOUT_MS を指定できます。リモートのテストネットサービスを使用するには、AGENTTOLL_NETWORK=base-sepolia と AGENTTOLL_RECIPIENT を明示的に設定してください。テストネットの USDC では、ホストされたメインネット API の料金を支払えません。

npm run example:client
npm run example:langchain

これらのコマンドは AGENT_PRIVATE_KEY を使って有料リクエストを行います。LangChain ツールはフレームワークのキャンセルシグナルを転送します。snapshot/demo/findings スクリプトも上限付きヘルパーを使用します。dist をインポートするため、先にビルドしてください。scripts/demo.mjs --dry は、検証済みの見積もりを確認するだけです。

CrewAI Python の例では、依存関係を固定した別の上限付きクライアントを使用します。このクライアントには、$0.003 のトークン安全上限、信頼済みのオリジン/受取人/ネットワークの確認、共有の有限予算が備わっています。処理期限には署名とレスポンス本文の読み取りも含まれます。インストール方法と、支払い結果が不確かな場合の対処については、ガイドを参照してください。

MCP

MCP パッケージはバージョン 0.14.0 で、有料ツールが 21 個、無料ツールが 2 個あります。見積もり専用モードで起動するには、AGENT_PRIVATE_KEY を指定せずに実行してください。

{
  "mcpServers": {
    "agenttoll": {
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}

無料ツールは get_payment_budget と get_payment_quote です。有料ツールは get_price、get_base_gas、get_trending、get_base_token_price、get_base_address_info、get_fear_greed、get_base_trending_pools、get_market_brief、get_new_token_radar、get_try_premium、get_try_spread、get_base_portfolio、check_token_safety、scout_new_tokens、get_fresh_pools、get_radar_history、get_radar_scorecard、resolve_basename、watch_base_address、watch_new_tokens、watch_price_alert です。

支払いを有効にするには AGENT_PRIVATE_KEY を追加し、セッション上限を設定するには AGENTTOLL_BUDGET_USDC を指定してください。MCP はデフォルトでホストされたメインネットのオリジンを使用し、カスタムオリジンには AGENTTOLL_RECIPIENT が必要です。get_payment_quote が受け付けるのは登録済みのエンドポイントパスのみで、任意の URL は指定できません。ツールのキャンセルは支払い用 HTTP リクエストに伝播します。価格と設定の一覧は mcp/README.md を参照してください。

バージョン 0.13.0 以前のインストールをアップグレードするには、パッケージ引数を [email protected] に変更し、MCP プロセスを再起動してください。以前に公開されたこれらのパッケージには、無料の見積もり/予算ツールや、文書化されている累積予算、信頼済み受取人、キャンセル制御はありません。旧コードをすでに実行中のプロセスは、自動更新されません。

HTTP サービスは x402 v2 を使用します。署名済みの再試行リクエストは従来の X-PAYMENT ではなく PAYMENT-SIGNATURE として送信し、見積もりは PAYMENT-REQUIRED から、領収書は PAYMENT-RESPONSE から取得してください。v1 ペイロードのヘッダー名を変更するだけではなく、v2 クライアントを使用してください。拒否された旧形式のリクエストには、明示的な移行案内が返されます。アドレス監視のカーソルは不透明な値として扱い、変更せずに渡してください。初回の since 値に限り、ISO タイムスタンプを指定できます。

発見と開発

npm test                 # deterministic offline regressions
npm run typecheck        # API, browser and MCP
npm run check:generated  # manifests, descriptions, examples and version consistency
npm run build            # synchronize shared files, compile and build browser bundle
npm run build:web        # browser bundle only
npm run brand:png        # brand exports

開発時のチェックでは、外部データや決済との境界をモックします。実際の決済や変更のデプロイは行いません。ルートと MCP は別々の依存関係ツリーです。両方を監査してください。認証情報、信頼境界、既知の制限については SECURITY.md を参照してください。

範囲を限定した署名なしのヘルス/カタログ/見積もりチェックには npm run ops:check、実際のスナップショットの経過時間とデータソースの網羅率には npm run ops:data、オフラインで使用状況/エラー/レイテンシと決済診断の概要を確認するには npm run ops:report -- --input requests.ndjson を使用してください。Keep-warm と scout のスナップショットスクリプトでは、ビルド後に明示的な --dry-run モードと --quote-only モードを使用できます。統計スナップショットのジョブは、検証済みの確定済みチェックポイントから再開し、レガシーなベースラインを一度再構築します。制限、メトリクスの定義、読み取り専用の監視、スケジュールされたジョブ、リリース/ロールバックについては OPERATIONS.md を参照してください。

MCP パッケージのバージョンを変更した後は、リポジトリのルートで npm run generate を実行してください。承認済みのリリースタグは mcp-v と一致する必要があります。このワークフローでは、両方の依存関係ツリー、生成されたアーティファクト、テスト、型をチェックした後、npm tarball をビルドしてスモークテストを実施してから公開します。

MIT。このリポジトリは agenttoll.app の独立した AgentToll プロジェクトであり、他所で運営されている類似名のサービスとは別のものです。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。