ToolSnap MCP

ToolSnap MCP

1つの接続で、エージェントに強力な機能を。決定論的なマイクロツールを提供します。Base上でUSDCを使い、アカウント不要で呼び出しごとに支払えます。暗号資産を使いたくない場合は、カードで法定通貨のクレジットを購入できます。

ライブエンドポイント： https://mcp.toolsnap.app/mcp
サーバーカード： /.well-known/mcp.json
料金： /.well-known/pricing.json
ドキュメント： mcp.toolsnap.app/docs

---

特長

ToolSnapは、3つの理念に基づいて構築されています。

1. 決定論的 — LLMを介しません。 現在、多くのエージェントスタックは、Webページを「クリーンアップ」するために、2つ目のモデルに要約させています。ToolSnapの抽出処理は純粋なパースです。正確な引用、安定した出力、追加の推論コストゼロ、再現可能な実行を実現します。抽出されるのは、ページに書かれていた内容そのものです。

2. コンテキスト効率を重視した設計。 AIエージェントの最大のコストは生成ではなく、コンテキストです。生のWebページを読み込むと、HTMLの定型部分だけで50,000トークン以上を消費することがあります。肥大化したMCPサーバーに接続すると、ツール定義だけで同程度のトークンを消費することがあります。ToolSnapは処理をサーバー側に移し、ツールの検出もコンパクトに保ちます。tools/listには厳選された基本ツールのみが表示され、Web、PDF、CSV/JSON、サイトマップ、RSS、画像、メディア生成など47個のマイクロツールからなるカタログ全体は、無料のtool_catalog()を1回呼び出すだけで参照でき、use_tool経由で実行できます。

ベンチマーク（実際の11ページ、2026年6月）：

	生HTML	抽出後	削減量
トークン数の中央値	53,820	2,001	98.1%
Sonnetでのコスト（$3/M）	$0.162	$0.006	1回あたり$0.156
損益分岐となるページサイズ	—	—	26 KB

fetch_extractは無料です。この削減によるコストはかかりません。

3. アカウント不要（暗号資産を利用する場合）。 接続すれば、すぐに無料ツールを使えます。有料ツールは、x402を介してBase上のUSDCで呼び出しごとに決済されます。ウォレットを持つエージェントなら、登録、サブスクリプション、キー管理なしで、そのまま支払えます。暗号資産を使いたくない場合は、カードで法定通貨のクレジットを購入して、代わりにAPIキーを取得できます。呼び出しごとの料金は同じ割引価格で、ウォレットは不要です。

---

接続

あらゆるエージェントに、1行で接続

次のプロンプトをエージェントに渡せば、あとは自動で処理できます。

Set up https://mcp.toolsnap.app/SKILL.md — connect the MCP server it describes and save the skill for future sessions.

SKILL.mdは、単体で利用できるスキルファイルです（接続設定、ツールの検出、コスト管理のガードレールを含みます）。ツールレジストリからリアルタイムに生成されるため、常に最新の状態です。

Claude Desktop

{
  "mcpServers": {
    "toolsnap": {
      "url": "https://mcp.toolsnap.app/mcp",
      "transport": "streamable-http"
    }
  }
}

上記のURL接続を使えば、無料ツールはすぐに利用できます。**有料ツールにはx402決済クライアントが必要です。**ウォレットだけでは不十分です。ほとんどのMCPクライアントは、402 Payment Requiredに単独で対応できないためです。以下の決済プロキシを使用してください。

Claude Code

claude mcp add --transport http toolsnap https://mcp.toolsnap.app/mcp

または、Claude Codeプラグイン（MCP接続とtoolsnapスキルを同梱）をインストールできます。

/plugin marketplace add ToolSnap-app/toolsnap-claude-plugin
/plugin install toolsnap

有料ツール — pay-proxy 経由で接続

scripts/pay-proxy.mjs はローカルの stdio MCP サーバーです。リモートエンドポイントをラップし、ウォレットを読み込み、サーバーから支払いを求められた場合は自動で署名して再試行します。秘密鍵がホストの外に出ることはなく、送信されるのは署名のみです。

{
  "mcpServers": {
    "toolsnap": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/to/toolsnap-mcp/scripts/pay-proxy.mjs"]
    }
  }
}

ウォレットをまだお持ちでない場合は、wallet_setup ツールを呼び出してください。ご自身で管理できるウォレットを生成し、USDC on Base をチャージするよう人間の担当者を支援して、このプロキシを設定します。鍵の解決順序：TOOLSNAP_WALLET_KEY → ~/.toolsnap/wallet.key → macOS Keychain（toolsnap-agent-wallet/default）。

便利な環境変数：TOOLSNAP_MAX_PRICE_USDC（1 回あたりの支出上限。デフォルトは 0.10）、TOOLSNAP_PREPAID=1 + TOOLSNAP_AUTO_DEPOSIT_USDC（より安価なプリペイド残高を使用）。

有料ツール — ウォレット不要、カードで支払い

mcp.toolsnap.app/checkout でクレジットを購入してください（当社の Merchant of Record である Polar が処理します）。ワンタイムポップアップで API キーが発行されます。プロキシは不要で、キーを使って直接接続できます。

{
  "mcpServers": {
    "toolsnap": {
      "url": "https://mcp.toolsnap.app/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

カスタムヘッダーを送信できないクライアント（claude.ai の一部のコネクターなど）では、代わりに URL にキーを埋め込めます：https://mcp.toolsnap.app/mcp/sk_live_...（この場合、クライアントのリクエストログにキーが表示される可能性があります。クライアントが対応している場合は、ヘッダーを使用してください）。

MCP を直接呼び出す

curl -X POST https://mcp.toolsnap.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

---

ツール

ツールは合計 47 個あります。tools/list には厳選された主要ツール 17 個が表示されます。それ以外のツールは、無料の tool_catalog ツールで見つけて、use_tool(name, args) で実行してください。

有料（x402）

ツール	説明	料金
screenshot_url	ページをキャプチャ → 公開画像 URL。	$0.04 USDC
fetch_rendered	JS ページ（SPA）をヘッドレスブラウザーでレンダリング → クリーンなテキスト。	$0.04 USDC
keyword_research	DataForSEO 経由で Google Ads の検索ボリューム／CPC／競合状況を取得。	$0.04 USDC
remove_background	画像の背景を削除 → 透明 PNG の URL。	$0.03 USDC
image_generate	fal.ai FLUX によるテキストから画像への生成。	$0.02 USDC から
image_upscale	fal.ai ESRGAN による 2x／4x 超解像。	$0.02 USDC から
audio_transcribe	fal.ai Wizper による音声からテキストへの変換。	$0.02 USDC から
text_to_speech	fal.ai Kokoro によるテキストから音声への変換。	$0.02 USDC から
video_generate	fal.ai による非同期のテキスト／画像から動画への生成。	$0.08 USDC から
csv_query_xl / json_query_xl	URL でホストされた CSV（5～100 MB）／JSON（5～25 MB）をクエリ。	$0.02 USDC

初回無料ではありません。これらのツールには実際の呼び出しごとのコストがかかるため、最初の呼び出しから毎回決済されます。メディアツールは、指定した引数に応じて呼び出しごとに料金が設定されます（表には最低料金を記載）。従量課金は x402 v2（EIP-3009 transferWithAuthorization）を使った Base 上の USDC 決済です。プリペイド（暗号資産またはカードで一度入金し、オフチェーンで引き落とし）は、呼び出しごとの料金がより安くなります。

無料（常時）

主なツール：fetch_extract（URL → クリーンなテキスト。生の HTML と比べてトークン数の中央値を 98.1% 削減）と fetch_html（URL → クリーンな構造化 HTML）。さらに、幅広いユーティリティカタログがあります。

ツール	説明
pricing	機械可読な料金メニュー。まずこれを呼び出してください。
tool_catalog	ツールカタログ全体を確認（ファミリー → 詳細）。
use_tool	tools/list にない任意のツールを実行。
memory_snippet	ハーネスの永続メモリに追加する ToolSnap の習慣ブロックを取得。
task_recipes	タスク全体を実行する、すぐに使える複数ツールのワークフロー。
uuid_generate	ランダムな UUID v4 値を 1～100 個生成
hash_text	SHA-256／SHA-1／SHA-512（16 進数）
base64_encode / base64_decode	Base64 のエンコード／デコード
url_encode / url_decode	パーセントエンコード／デコード
json_format	JSON を解析して整形、または最小化
timestamp_convert	Unix ↔ ISO 8601（方向を自動判定）
text_stats	文字数、単語数、行数、文数

スキーマと料金を含む最新の完全なリストは、tool_catalog() を呼び出して確認してください。

---

Payment（x402）

エージェントが支払いなしで有料ツール（例：screenshot_url）を呼び出すと、サーバーは次を返します。

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": 402,
    "message": "Payment required",
    "data": {
      "x402Version": 2,
      "accepts": [{
        "scheme": "exact",
        "network": "eip155:8453",
        "amount": "40000",
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      }]
    }
  }
}

x402 対応クライアントは accepts[0] を読み取り、EIP-3009 TransferWithAuthorization に署名して、_meta["x402/payment"] を設定して再試行します。詳細は x402 の仕様をご覧ください。

---

ローカルで実行する

npm install
cp .dev.vars.example .dev.vars  # fill in wallet secrets
npm run dev
# Worker at http://localhost:8787

型チェック

npm run typecheck

デプロイ

npm run deploy

---

技術スタック

• ランタイム： Cloudflare Workers（エッジ、コールドスタート 0 ms）
• プロトコル： MCP streamable-http（JSON-RPC 2.0）
• 支払い： x402 v2 · Base メインネット上の EIP-3009 · USDC
• 検証： オフチェーン EIP-712 署名の復元（viem）
• 決済： リレイヤーウォレット経由のオンチェーン transferWithAuthorization
• リプレイ対策： Cloudflare KV nonce ストア（TTL 7 日）
• 初回呼び出し無料： 将来の定額料金ツール向けの仕組みがコード内にあります（KV キー first_free:{address}）。現在の有料ツールはすべて実際の COGS が発生するため対象外となり、すべての呼び出しで決済が行われます

---

コントリビューション

src/tools/ への新しい無料ツールの PR を歓迎します。src/tools/text-stats.ts のパターンに従い、src/tools/index.ts にツールを追加してください。

有料ツールや x402 の決済ロジックを変更する場合は、まず issue を作成してください。

ウォレットの秘密鍵、.dev.vars、その他のシークレットをコミットしないでください。

---

---

ライセンス

MIT