Agent Utilities

Agent Utilities MCP

ホスト型の Streamable HTTP 接続も https://agent-utilities.agent-utilities.workers.dev/mcp/remote で利用できます。無料のリソースと呼び出しの準備に加え、既存のクレジットと非公開の Authorization ヘッダーを使用した有料の実行を提供します。この接続では、ローカルの Node プロセスは必要ありません。ホスト型 MCP ガイドをご覧ください。ラップされたツール引数は、このローカルアダプターとは異なります。OAuth とウォレット署名は提供されません。

ローカルの stdio MCP クライアントを、HTML 抽出、JSON 検証、エージェント設定のチェック、製品データに対応する有料ユーティリティ API の最新カタログに接続します。この MIT ライセンスのアダプターはローカルで実行されます。ホスト型 API は有料サービスです。

ツールカタログ · インストールガイド · 料金 · ポリシーとサポート

VS Code ユーザー：セットアップリンクと非公開キーの設定を開く。このソースリポジトリには、詳細な手順が含まれています。

Cursor または VS Code でホスト型 MCP に接続する

ローカルの Node.js プロセスは必要ありません。これらのセットアップリンクに含まれるのは、サーバー名と公開エンドポイントのみで、API キーや支払い承認情報は含まれていません。

• Cursor でホスト型 Agent Utilities をセットアップする
• VS Code でホスト型 Agent Utilities をセットアップする

承認する前に、インストール済みの MCP 対応アプリケーションで設定を確認してください。インストールの適用範囲を確認し、ツールの承認を有効にしたままにしてください。これらのリンクで設定されるのはホスト型接続であり、この README の別の箇所で説明されているローカルアダプターではありません。

エンドポイント： https://agent-utilities.agent-utilities.workers.dev/mcp/remote（Streamable HTTP）。別のレガシー /mcp JSON-RPC エンドポイントは動作が異なり、これらのセットアップで使用されるエンドポイントではありません。

無料と有料： 検出、提供データのプレビュー、および agent_utilities_seo_audit には、Agent Utilities アカウントや API キーは必要ありません。無料の SEO 監査は提供されたスナップショットを対象としており、任意の URL をクロールするものではありません。有料カタログの 49 個のツールには、既存のサービスクレジットと非公開の Authorization: Bearer API キーヘッダーに加え、ホスト型 MCP ガイドに記載されている準備済みの入力、リクエスト ID、価格上限が必要です。このセットアップによって、アカウントが作成されたり、クレジットが購入されたり、支出が承認されたりすることはありません。OAuth は提供されません。API キーをインストールリンク、共有設定、チャットに記載しないでください。

リンクが開かない場合の手動セットアップ

該当するサーバーエントリを既存の設定に統合し、ほかのサーバーはそのまま残してください。

Cursor： このプロジェクトでは .cursor/mcp.json を、ユーザー全体の設定では ~/.cursor/mcp.json を使用してください。

{
  "mcpServers": {
    "agent-utilities-hosted": {
      "url": "https://agent-utilities.agent-utilities.workers.dev/mcp/remote"
    }
  }
}

VS Code： 現在のユーザープロファイルで MCP: Open User Configuration を実行し、このネイティブな VS Code 形式を統合してください。ワークスペースのみのネイティブ設定では .vscode/mcp.json を使用してください。現在の VS Code はポータブルな .mcp.json にも対応しています。形式を選ぶ前に、ドキュメントを確認してください。

{
  "servers": {
    "agent-utilities-hosted": {
      "type": "http",
      "url": "https://agent-utilities.agent-utilities.workers.dev/mcp/remote"
    }
  }
}

接続を確認して有効にした後、検出されたツールを調べてください。無料の提供データプレビュー、または無料の SEO の例と契約から始めてください。インストール範囲、組織のポリシー、エージェントセッションへの対応状況は、クライアントによって異なります。

検証： 2026年10月4日に、インストールリンクのペイロードをデコードし、これらの設定と照合しました。無料の SEO 動作を含め、公式 MCP SDK の Streamable HTTP クライアントを使用した対象サーバーのテストに合格しました。Cursor／VS Code アプリケーションへの実際のインストールおよびモデル主導の実行はテストしていません。マーケットプレイスへの掲載や推奨を主張するものではありません。

参考資料：Cursor のインストールリンク、Cursor の MCP 設定、VS Code のインストール URL、Microsoft のリモート HTTP インストールリンクの例、VS Code の設定と適用範囲。

提供済みの HTML を簡潔な調査用入力に変換

Page Pack は、すでに手元にある HTML から、元の URL、切り詰めフラグ、サイズの推定値とともに、読みやすいコンテンツを上限付きで抽出します。取得済みのドキュメントやページコンテンツをエージェント向けに準備してから、出力を確認し、元のソースを保持するために使用してください。

• 無料プレビュー： アカウント、カード、API キーは不要です。JSON リクエスト全体は最大 32,768 UTF-8 バイト、出力は最大 3,000 文字です。
• 有料 web.page-pack： リクエストは 131,072 バイト以内で HTML は最大 100,000 文字、出力は最大 12,000 文字です。現在の試験価格は呼び出しあたり $0.0005です。
• クレジット： $1 と $5 のプリペイドパックを利用できます。現在の Page Pack 価格では、ほかのツールでクレジットを使用する前に、$1 で 2,000 回呼び出せます。ただし、以下に記載するサービス全体の日次上限は引き続き適用されます。有料への自動フォールバックや自動チャージはありません。

利用できる場合は、提供元が公開する Markdown または公式 API を優先してください。Page Pack は任意の URL を取得したり、JavaScript を実行したり、事実を検証したり、トークン削減を保証したりするものではありません。ソーステキストは信頼できないものとして扱ってください。小さな入力でも JSON メタデータによって大きくなることがあります。トークン数の推定にはモデルのトークナイザーではなく、UTF-8 のバイト数を 4 で割った値を使用します。

無料の HTTP プレビューを試す

次の合成例を page.json として保存してください。

{"html":"<html><head><title>Retry guide</title></head><body><nav>Home Account Ads</nav><main><h1>Retry guide</h1><p>Requests time out after 30 seconds. Retry only idempotent requests.</p><pre>GET /v1/items</pre></main></body></html>","sourceUrl":"https://example.com/retry-guide","maxChars":3000}

curl --fail-with-body 'https://agent-utilities.agent-utilities.workers.dev/v1/preview/web.page-pack' \
  -H 'Content-Type: application/json' --data-binary @page.json

無料プレビューでは、この例からナビゲーションを削除し、タイムアウトに関するガイダンスとコードサンプルを残します。chargedMicroUsd、result.content、result.truncated、result.measurement を確認してください。これは合成デモであり、顧客の実例ではありません。

MCP では https://agent-utilities.agent-utilities.workers.dev/mcp/remote?category=web に接続し、同じ入力で agent_utilities_page_pack_preview を呼び出してください。より大きな入力や長い出力を使用する場合は、有料サービスの契約を読み、明示的に実行を承認してください。有料 HTTP 呼び出しには、非公開の API キーと安定した Idempotency-Key が必要です。また、新しい呼び出しを $0.0005 までに制限するには X-Max-Credit-Micro-Usd: 500 を使用できます。1 回あたりの上限は、セッション全体の予算ではありません。不確実な状況が発生した場合は、以下の復旧手順に従ってください。

SEO エージェンシー向け

無料の SEO 監査をお試しください。これは別途提供される無料のエントリーポイントです。上記で説明した有料の Page Pack の利用枠は、提供された HTML の抽出に適用されます。

ライブカタログには現在、無料のリソースやプレビューとは別に、49 個の有料ツールが掲載されています。2026 年 10 月 4 日に確認済みです。ホスト型 MCP サーバーのバージョンは 1.9.0 です。このリポジトリのローカル stdio アダプターと変更不可能な MCPB リリースのバージョンは、引き続き 0.3.0 です。これらは別々のコンポーネントであり、バージョン番号を相互に置き換えることはできません。

USDC による従量課金

Circle Gateway の残高を持つエージェント向けに、別途提供されるスタンドアロンの USDC クライアントでは、Stripe のクレジットパックを使わずに Base メインネットで支払えます。サンプルをダウンロードしてプレビューする。ネットワークとコントラクトを固定し、各呼び出しに上限を設け、署名済みリクエストを復旧用に非公開で保存します。プレビューはオフラインで実行されます。準備と送信には、それぞれ別の明示的なコマンドが必要です。実際に実行すると、実際の USDC が使用されます。このクライアントは Stripe 資金を使用する MCP アダプターとは別のものであり、変更不可能な MCPB 0.3.0 リリースには含まれていません。

アカウントなしでショッピングの例を試す

このリポジトリをクローンし、Node.js 22+ で提供されているカートをプレビューします。

cd examples/cart
shasum -a 256 -c cart-workflow.mjs.sha256
node cart-workflow.mjs --preview cart-example.json

プレビューでは入力を検証し、API キー、ネットワークリクエスト、料金なしで、3 ステップの計画をオフラインで出力します。ツールは実行されません。含まれている期待される出力はローカルのフィクスチャです。ドイツ語の価格表記を小数値に変換し、保護されたパッチで提供されたカートのスナップショットを更新すると、コストの照合によって既知の合計 €45.92 が返されます。税額は不明のため、最終合計は null のままです。

この 3 つの操作をホスト型サービスに対して実行するには、プロセス環境に AGENT_UTILITIES_API_KEY を非公開で設定し、次のコマンドを明示的に選択します。

node cart-workflow.mjs --execute cart-example.json

実行すると、既存のサービスクレジットが使用されます。このレシピでは、3 回の論理呼び出しの合計で最大 $0.0013（0.13 セント）となるよう、呼び出しごとの価格上限を設定します。検出された価格が高すぎる場合や、後続の価格が承認済みの上限を超える場合は処理を停止します。後続のステップが失敗しても、完了済みのステップへの課金は取り消されません。各ステップは課金の領収情報と復旧情報を返します。不確かな応答を受け取った場合は、レシピ全体を再実行しないでください。実行前にレシピの手順をお読みください。この例ではクレジットの購入や販売者への注文は行いません。

このレシピは別途ダウンロードできるスタンドアロンのもので、変更不可能な v0.3.0 MCPB バンドルには含まれていません。ワークフローページからも入手できます。汎用 MCP アダプターの課金動作については、以下の説明をご覧ください。

エージェントから素材を直接読む

契約、例、価格、ガイドを読むのに、アカウントやキーは必要ありません。

curl --fail --silent --show-error \
  https://agent-utilities.agent-utilities.workers.dev/v1/content/index?utm_source=github

• 完全な JSON コンテンツ：ツールの入出力スキーマ、リクエスト例、実行ヘッダー、ワークフロー、ドキュメント。
• ガイド全文：同じ内容をプレーンテキストで掲載しています。
• 1 つのツールの契約：リクエストスキーマ、例、価格、実行 URL。
• カートのワークフロー：手順と現在の合計価格。
• OpenAPI：HTTP ツールの操作、任意のクレジット上限ヘッダー、エラーレスポンス。

これらの公開 GET エンドポイントは、クロスオリジンでのブラウザー読み取りに対応しています。ツールの実行は有料のままです。カスタム HTTP クライアントでは X-Max-Credit-Micro-Usd を送信して、新たなプリペイドクレジットの引き落としに上限を設定できます。再試行の仕様については、クイックスタートをご覧ください。Adapter 0.3.0 は、新しい各呼び出しの上限を起動時のカタログ価格に設定し、サーバーがサポートを通知していることを必須とします。

Python をお使いですか？

Python HTTP クライアントは、Python 3.10 以降の標準ライブラリのみを使用します。オフラインプレビュー、無料の検出、呼び出しごとの上限と安定した再試行 ID を指定した明示的な有料呼び出しについては、examples/pythonをご覧ください。この方法では、Node も MCP プロセスも必要ありません。MCPB バンドルとは別のものです。

インストール

Smithery にも、ローカルの Node.js MCPB バンドルとして掲載されています。ダウンロード内容は v0.3.0 GitHub アーティファクトと一致します。最新の完全なツールスキーマと価格を確認するにはアダプターに接続してください。ディレクトリーのメタデータは概要です。

MCP バンドルに対応したクライアントでは、v0.3.0 リリースから agent-utilities-mcp-0.3.0.mcpb とそのチェックサムをダウンロードしてください。クライアントの拡張機能設定からバンドルをインポートする前に、チェックサムを検証してください。バンドルにはアダプター、マニフェスト、ライセンスに関する通知が含まれています。バンドルには署名がありません。リリースのチェックサムはファイルの整合性を確認するもので、独立した署名ではありません。バンドルのスキーマと単体実行はテスト済みですが、各デスクトップクライアントへのインストールは検証されていません。

バンドルのオプション設定である Agent Utilities API key は機密情報として扱われます。無料でツールを確認する場合は空欄のままにし、有料の呼び出しを有効にする場合に限り、ご自身の API キーを入力してください。Node.js 22 以降が必要です。クライアントから提供される互換ランタイム、またはローカルにインストールしたランタイムを使用してください。クライアントが MCPB ファイルをインポートできない場合は、以下の手動セットアップを使用してください。

Node.js 22 以降が必要です。インストールガイドから agent-utilities-mcp.mjs とその .sha256 ファイルをダウンロードし、ファイルがあるフォルダーでファイルを検証してください。

shasum -a 256 -c agent-utilities-mcp.mjs.sha256

または、このリポジトリーをクローンし、同梱の agent-utilities-mcp.mjs を直接使用してください。バンドルの実行に npm install は不要です。ソースは src/ にあります。npm ci && npm run build で再ビルドできます。公開バンドルは、アプリケーションの依存関係ツリーの外部で単独プロセスとしてテストされています。

一般的な mcpServers 設定形式を使用するクライアントの場合：

{
  "mcpServers": {
    "agent-utilities": {
      "command": "node",
      "args": ["/absolute/path/agent-utilities-mcp.mjs"],
      "env": {
        "AGENT_UTILITIES_API_KEY": "YOUR_PRIVATE_API_KEY"
      }
    }
  }
}

ファイルパスを置き換えてください。対応している場合は、クライアントのシークレット設定を使って API キーを非公開で設定してください。実際のキーをコミットしたり、エージェントのプロンプトに貼り付けたりしないでください。クライアントが Node の場所を特定できない場合は、絶対パスを使用してください。リモート MCP クライアントのみを利用する場合は、上記のホスト済み Streamable HTTP エンドポイントを使用してください。有料の呼び出しには、非公開の Authorization ヘッダーと、ホスト型 MCP ガイドに記載されたラップ済み引数が必要です。

クレジットを消費せずにツールを確認するには、キーを省略してください。ワークスペースで API キーと、別途保存されるリカバリーキーを取得してください。API キーはアダプターにのみ渡してください。ライブモードでは、1 ドルまたは 5 ドルの USD 前払いサービスクレジットパックを販売しています。購入前に表示されているモードを確認してください。

機能

• 起動時に公開されているツール定義と、現在の呼び出しごとの価格を取得します。
• 現在のカタログから検出したサービスツールと、リカバリーヘルパーを 1 つ公開します。リカバリーヘルパーは追加の製品ではありません。
• 認証済みの呼び出しは、固定された Agent Utilities のオリジンにのみ送信します。リダイレクトは拒否されます。
• 安定したデビット要求 ID を生成し、HTTP 通信に失敗した場合は、同一の本文と ID で 1 回再試行します。
• 要求 ID と入力ハッシュはプロセスメモリー内に保持し、入力、結果、認証情報はログに記録しません。リモートでのデータの取り扱いについては、サービスのポリシーに記載されています。
• クレジットの購入や自動チャージ、ウォレットへのアクセス、リカバリー認証情報の受け付けは行いません。

「commerce_gtin_validate を使ってバーコード 036000291452 を確認してください」のような便利なタスクを試してみてください。呼び出しが 1 回成功すると $0.0003 かかります。現在のツール価格は $0.0003～$0.003 です。これらは実験的な価格であり、今後も同じとは限りません。操作を新たに行うたびにクレジットを消費します。バージョン 0.3.0 では、新たなデビットの上限が起動時に検出した価格に設定されています。セッション全体の予算はなく、新たな呼び出しを繰り返すと、利用可能な残高を使い切る場合があります。サーバー価格が上昇した場合は、上限が引き上げられるのではなく、HTTP 412 が返されます。価格を更新して確認してから再起動してください。クライアントで価格を確認し、支出を承認してください。

不確かな結果を再試行する

結果と不確かな結果には requestId が含まれます。その ID、元の MCP ツール名、元の引数を指定して agent_utilities_retry を呼び出します。

{
  "requestId": "COPY_THE_RETURNED_REQUEST_ID",
  "name": "commerce_gtin_validate",
  "arguments": { "code": "036000291452" }
}

10 分以内であれば、完了したリクエストは追加の課金なしで保存済みの結果を返します。バージョン 0.3.0 では、復旧ヘルパーは上限を 0 にしてリクエストを送信します。サービスに到達しなかったリクエストは、新しい予約なしで拒否されます。これは以前の予約を取り消したり、課金を返金したりするものではありません。新しい呼び出しに対する自動トランスポート再試行では、元の 0 以外の上限が維持され、承認済みの操作が 1 回実行される場合があります。不確かな結果を復旧する際に、新しい ID を生成したり、入力を変更したりしないでください。期限切れのリクエスト ID では、追加の課金は発生しません。同じプロセス内で MCP リクエスト ID を再利用した場合も、元の課金 ID が維持されます。

プロセスの再起動後に復旧するには、返されたリクエスト ID と元の入力が必要です。クライアントが ID を受け取る前にプロセスが停止した場合は、操作を繰り返す前に残高を確認するか、サポートにお問い合わせください。入力や結果の履歴はローカルに永続保存されません。各プロセスが保持できる MCP リクエスト ID は最大 5,000 個です。その後は再起動するまで新しい呼び出しが拒否されるため、先に保留中の復旧を完了してください。

サービスの制限

個別ツールのサービスでは、サービス全体で決済レールごとに、1 日あたり最大 1,000 件の新規有料呼び出しを試行できます。HTTP とホスト型 MCP はクレジットレールの容量を共有します。既存の一致するリクエストの再試行では、新たな課金は発生しません。プロトコルのオーバーヘッドを含め、入力は 128 KiB に制限されています。ネットワークツールの接続先はカタログに記載されたホストに制限されており、一般的なウェブブラウザーではありません。セキュリティチェックはヒューリスティックです。成功した結果は、10 分間の再試行復旧に備えて暗号化され、リクエストのトゥームストーンは 1 日間保持されます。保持と返金の詳細については、ポリシーをご覧ください。

自動テストでは、ローカルの Cloudflare クレジット台帳を使って、応答が失われた場合の復旧を検証します。顧客の需要を立証したり、実際の顧客による購入を証明したりするものではありません。ディレクトリの検証と無料のツール検索は、販売実績ではありません。

ライセンス

アダプターコード：MIT。バンドルされている依存関係については、THIRD-PARTY-NOTICES.txt をご覧ください。このライセンスの対象はアダプターであり、ホスト型 API への無料アクセスではありません。

買い物タスクに必要なパックを選ぶ

パックプランナーは、明示的なパック上限を使って、互換性のある商品の必要数をそろえるための最小商品小計を算出します。12個の商品は、10個入りパックが単価で安くても、7.99ドルの6個入りパックを2つ購入すれば15.98ドルでそろえられます。この操作の料金は、前払いクレジットで0.0008ドルです。送料、税金、クーポン、商品の同等性は最適化の対象外です。

MCP 経由で commerce_pack_plan を呼び出すか、ツール ID commerce.pack-plan と明示的な800マイクロドルの上限を指定して、Python クライアントを使用します。実行前に無料の JSON コントラクトを確認してください。実行例のワークフローでは、在庫上限と、パック数をカートの照合に反映する方法を説明しています。アダプターはサービスからこのツールを検出するため、新しいツールを使う際にアダプターを置き換える必要はありません。

Python のパック計画の例を3つのサンプルケースで試してください。examples/pythonからpython3 pack_plan_example.pyを実行するか、--scenario limited-stock／--scenario insufficient-stockを選択します。デフォルトでは、固定のフィクスチャをオフラインで表示します。リクエストは送信せず、新しい結果も計算しません。--executeを追加すると、既存のクレジットを使用して、上限0.0008ドルのホスト済み呼び出しを1回実行することを明示的に許可します。有効な実行不能結果も課金対象です。実行前に、チェックサム、入力制限、復旧方法についてPython ガイドを確認してください。実行するたびに新しい ID が作成されます。不確かな有料結果を復旧するために再実行しないでください。

0.2.1 からのアップグレード

呼び出しごとの価格上限と、復旧専用の手動再試行を利用するには、0.3.0 をインストールしてください。バージョン0.2.1では、これらのアダプター保護は適用されません。既存の0.2.1リリースのバイナリは引き続き利用でき、変更もありません。アップグレードするには、インストール済みのアダプターを置き換える必要があります。呼び出しごとの上限は、新しい呼び出しの回数を制限したり、セッション全体の予算を設定したりするものではありません。

購入手続き後の合計金額を比較する

examples/python/compare_carts.pyにある標準ライブラリのみを使う Python レシピは、カートごとに上限付きの照合を1回行い、指定された販売業者の購入手続きスナップショットを比較します。デフォルトのプレビューはオフラインです。実行には--executeと既存のクレジットが必要です。合計金額がすべてそろっているカートを順位付けし、同額の場合はそのまま残します。また、送料、税金、手数料が不明なカートがある場合は、総合的な勝者を決めません。2つのカートを比較する場合のデフォルトの上限は0.001ドルです。サンプル入力、チェックサム、明示的な予算、復旧方法については比較ガイドを参照してください。