ToolSnap MCP

ToolSnap MCP

一次连接，为你的 Agent 解锁超能力：确定性微型工具。使用 Base 上的 USDC 按次付费——无需账户；如果不想接触加密货币，也可以刷卡购买法币额度。

在线端点： https://mcp.toolsnap.app/mcp
服务卡片： /.well-known/mcp.json
定价： /.well-known/pricing.json
文档： mcp.toolsnap.app/docs

---

为什么选择 ToolSnap

ToolSnap 围绕三个理念打造：

1. 确定性——流程中不涉及 LLM。 如今，大多数 Agent 技术栈会花钱调用第二个模型来总结网页，从而对网页进行“清理”。ToolSnap 的提取完全基于解析：原文引用准确、输出稳定、不增加推理成本、运行结果可复现。提取的内容就是网页上的原文。

2. 从设计上节省上下文。 AI Agent 的最大成本不是生成内容，而是上下文。加载原始网页可能因为 HTML 样板内容消耗 50,000+ 个 token；连接一个臃肿的 MCP 服务，工具定义也可能消耗同样多的 token。ToolSnap 将工作放到服务端执行，同时保持发现过程精简：tools/list 显示精选的核心工具，而包含 47 个微型工具（网页、PDF、CSV/JSON、站点地图、RSS、图像、媒体生成……）的完整目录只需调用一次免费的 tool_catalog() 即可查看，并通过 use_tool 执行。

基准测试（11 个真实网页，2026 年 6 月）：

	原始 HTML	提取后	节省
Token 中位数	53,820	2,001	98.1%
Sonnet 成本（$3/M）	$0.162	$0.006	$0.156/次调用
盈亏平衡页面大小	—	—	26 KB

fetch_extract 免费——节省成本无需付费。

3. 无需账户（加密货币支付方式）。 连接后即可立即使用免费工具。付费工具通过 x402 使用 Base 上的 USDC 按次结算——拥有钱包的 Agent 可以直接付款：无需注册、无需订阅、无需管理密钥。不想接触加密货币？刷卡购买法币额度 并获取 API 密钥即可——按次价格同样优惠，也无需钱包。

---

连接

任何 Agent，一行提示词

将以下提示词交给你的 Agent，它就能自行完成后续操作：

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。请使用下面的支付代理（如果你的副本早于 2026-10 采用规范格式的 402 版本，请重新下载，参见支付）。

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 在 Base 上为其充值，并配置此代理。密钥解析顺序：TOOLSNAP_WALLET_KEY → ~/.toolsnap/wallet.key → macOS Keychain（toolsnap-agent-wallet/default）。

常用环境变量：TOOLSNAP_MAX_PRICE_USDC（单次调用消费上限，默认值为 0.10），TOOLSNAP_PREPAID=1 + TOOLSNAP_AUTO_DEPOSIT_USDC（使用更便宜的预付余额）。

付费工具 — 无需钱包，使用银行卡付款

在 mcp.toolsnap.app/checkout 购买额度（由我们的备案商家 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 搜索量／每次点击费用／竞争度。	$0.04 USDC
remove_background	移除图片背景 → 透明 PNG URL。	$0.03 USDC
image_generate	通过 fal.ai FLUX 将文本转换为图像。	$0.02 USDC 起
image_upscale	通过 fal.ai ESRGAN 进行 2 倍／4 倍超分辨率处理。	$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

首次调用不免费：这些工具每次调用都会产生实际成本，因此从首次调用起就会结算。媒体工具的价格按你提供的参数逐次计算（表中显示的是最低价）。按次付费使用 Base 上的 USDC，通过 x402 v2（EIP-3009 transferWithAuthorization）结算；预付费（一次充值、链下扣款，可使用加密货币或银行卡）每次调用更便宜。

免费（始终免费）

旗舰工具：fetch_extract（URL → 清理后的文本，与原始 HTML 相比，中位数减少 98.1% 的令牌数）和 fetch_html（URL → 清理后的结构化 HTML）。此外还有丰富的实用工具目录：

工具	描述
pricing	机器可读的价格菜单。请先调用此工具。
tool_catalog	查找完整工具目录（分类 → 详情）。
use_tool	执行未列在你的 tools/list 中的任何工具。
memory_snippet	获取适用于你的运行环境持久化记忆的 ToolSnap 习惯说明块。
task_recipes	可直接运行的多工具工作流，用于完成完整任务。
uuid_generate	生成 1–100 个随机 UUID v4 值
hash_text	SHA-256 / SHA-1 / SHA-512（十六进制）
base64_encode / base64_decode	Base64 编码／解码
url_encode / url_decode	百分号编码／解码
json_format	解析并美化输出或压缩 JSON
timestamp_convert	Unix ↔ ISO 8601（自动检测转换方向）
text_stats	字符、单词、行、句子

调用 tool_catalog() 获取包含架构和价格的完整最新列表。

---

付款（x402）

当 Agent 在未付款的情况下调用付费工具（例如 screenshot_url）时，服务会返回符合 x402 v2 MCP 传输格式的工具结果：isError: true，structuredContent 中包含付款要求，并在 content[0].text 中以 JSON 编码相同的对象（第二个文本块包含后续步骤）：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": true,
    "structuredContent": {
      "x402Version": 2,
      "error": "Payment required to use this tool",
      "resource": { "url": "https://mcp.toolsnap.app/mcp#screenshot_url", "serviceName": "ToolSnap" },
      "accepts": [{
        "scheme": "exact",
        "network": "eip155:8453",
        "amount": "40000",
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "payTo": "0x…",
        "maxTimeoutSeconds": 300
      }],
      "extensions": { "bazaar": { "info": { "input": { "type": "mcp" } } } }
    },
    "content": [{ "type": "text", "text": "<the same JSON>" }, { "type": "text", "text": "Payment required: …" }]
  }
}

截至 2026-10，这原本是一个 JSON-RPC 错误（error.code: 402、error.data）。如果你之前下载过 scripts/pay-proxy.mjs，请重新下载：旧版本只能识别旧格式，不会自行付款。（预付存款验证仍会通过 JSON-RPC 402 错误响应，account_deposit。）

启用了 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