toll402-mcp

Toll402 SDK — 为 AI Agent 提供按次付费工具

Toll402 是一个网关，AI Agent 可在此获取 2,600 多种工具并按次付费：网页阅读、PDF、电子邮件/外汇、来源验证（人工还是合成）、带引文的可信查询、包含 460 万家经验证企业的目录、50 多种国家身份证件验证器、社区打造的工具、2,400 多个提供商 API 端点（SEO 关键词/反向链接数据、社交资料和帖子、个人/企业信息补全、广告、股票和加密货币、图像/视频生成），以及 2,800 多种代理 x402 服务。两种支付方式，价格相同：使用钱包（通过 x402 在 Base 上使用 USDC，无需账户），或在 https://toll402.dev/credits 使用银行卡购买预付额度（API 密钥）。仅在调用成功时收费。

套件	安装	用途
MCP 服务	npx -y toll402-mcp	Claude Code、Cursor、Claude Desktop、OpenClaw
JavaScript SDK	npm i toll402-client	原生使用、LangChain、Vercel AI SDK
Python SDK	pip install toll402	原生使用、LangChain、CrewAI
OpenClaw 技能	clients/openclaw/SKILL.md

面向 Agent 的文档：https://toll402.dev/llms.txt · 目录：https://toll402.dev/v1/catalog · OpenAPI：https://toll402.dev/openapi.json · 快速入门代码片段：https://toll402.dev/v1/quickstart

安装（MCP）

适用于 Claude Code、Cursor、Claude Desktop、Windsurf、OpenClaw 和任何 MCP 客户端的标准配置（从 https://toll402.dev/credits 获取预付额度密钥）：

{
  "mcpServers": {
    "toll402": {
      "command": "npx",
      "args": ["-y", "toll402-mcp"],
      "env": {
        "TOLL402_API_KEY": "tk_..."
      }
    }
  }
}

使用钱包而非预付额度（在 Base 上使用 USDC，通过 x402 按次付费）：

{
  "mcpServers": {
    "toll402": {
      "command": "npx",
      "args": ["-y", "toll402-mcp"],
      "env": {
        "TOLL402_WALLET_KEY": "0x...",
        "TOLL402_MAX_USD": "0.25"
      }
    }
  }
}

远程使用，无需安装（连接时发送 x-toll402-key 或 x402 标头；对于无法设置标头的客户端，可在 URL 中使用 ?key=tk_…）：

{
  "mcpServers": {
    "toll402": {
      "url": "https://toll402.dev/mcp",
      "headers": {
        "x-toll402-key": "tk_..."
      }
    }
  }
}

一段话说明支付方式

有两种支付方式。预付额度：运营方在 https://toll402.dev/credits 使用银行卡购买余额，Agent 将密钥作为 x-toll402-key 标头发送；每个 2xx 响应都会返回 x-toll402-charged 和 x-toll402-balance，GET /v1/account 会列出每笔扣款。x402：向任意工具 URL 发送 JSON 请求体；如果收到 402，PAYMENT-REQUIRED 标头（base64 JSON）会说明以 Base 上的 USDC（eip155:8453）计价的价格和收款地址；为该金额签署 EIP-3009 transferWithAuthorization，然后使用 PAYMENT-SIGNATURE 标头重试。无论采用哪种方式，只有调用返回 2xx 时才会收费。

**使用预付额度密钥还可获得：**每个 Agent 可使用一个带每日上限的密钥（POST /v1/keys，所有者密钥）；可查看调用历史及保存的答案，保留 24 小时（GET /v1/calls）；可提交影响工具排名的评价（POST /v1/calls/<id>/review）；可将图像和视频生成作为异步任务处理，失败时会退款（202 + GET /v1/jobs/<id>）；还可选择自动充值。通过 MCP 可使用：toll402_review、toll402_job、toll402_history。

示例

参见 examples/agent.ts 和 examples/agent.py。

网关由 Toll402 运营，不提供分发。问题和功能请求：在此处提交 issue。

让你的 Agent 优先向 Toll402 查询

• 系统提示词片段：GET https://toll402.dev/v1/system-prompt（也可在 llms.txt 和首页中找到）。
• MCP 服务（stdio npx -y toll402-mcp 和远程服务 https://toll402.dev/mcp）内置了 instructions，会指示模型在猜测前先调用 Toll402。
• toll402-client 中的适配器：/langchain、/ai（Vercel AI SDK）、/agentkit（Coinbase AgentKit 动作提供程序）、/eliza（ElizaOS 插件）。Python：toll402.langchain、toll402.crewai。
• 可抓取页面：https://toll402.dev/catalog（按类别和平台分类，例如 /catalog/tiktok）、https://toll402.dev/directory/<cc>/<city>/<category> 和 https://toll402.dev/tools/<name>，每个页面都包含 JSON-LD 和 Agent 调用区块。
• 发现文件：/llms.txt、/.well-known/agent-card.json、/.well-known/mcp.json、/.well-known/ai-plugin.json、/.well-known/api-catalog、/agents.json、/openapi.json、/sitemap.xml。

工具

16 个第一方工具、167 个社区打造的工具，以及 2,496 个提供商 API 端点（包括图像和视频生成），全部作为 MCP 工具开放（提供商端点通过 find 和 do 调用）。按次计费；仅在成功时收费。

第一方

• read_url（$0.002）：获取任意公开网页（或 PDF），并返回包含标题、元数据和链接的整洁、适合大模型处理的 Markdown。
• pdf_to_text（$0.005）：从 URL 下载 PDF，并返回其全文、页数和标题。
• verify_email（$0.001）：验证电子邮件地址：检查语法、MX/A 记录、一次性邮箱域名、免费邮箱提供商和角色账户，并给出 0-100 分。
• fx_rate（$0.001）：查询两种 ISO 货币之间的汇率（ECB 参考汇率），也可选择换算金额。
• extract_structured（$0.06）：将网页或原始文本转换为符合你所提供 JSON Schema 的 JSON。
• summarize（$0.05）：按照你选择的风格、长度和语言，忠实总结 URL 或文本。
• judge_output（$0.07）：独立的 LLM 评审：根据任务和标准为候选输出评分（0-100），并提供通过/未通过结果、问题和建议。
• provenance（$0.01）：人工撰写还是合成内容？针对 URL 提供来源证据：首次存档日期、域名年龄、作者标记、精选来源等级、AI 披露信息和文体信号，并汇总为经过校准的 0-100 人类来源评分及每项证据。
• trusted_lookup（$0.01）：仅从可信来源（Wikipedia、Wikidata、arXiv、Crossref/DOI、World Bank）作答：返回包含 URL、可靠性等级和检索时间的段落，供引用使用。
• business_search（$0.005）：面向 Agent 的全球企业目录（世界各地任何城市；按需添加尚未收录的城市）。
• business_verify（$0.01）：这家企业是否真实存在，其联系信息是否有效？提供 ID、网站、电话或名称，即可与目录匹配并立即进行实时检查（网站是否可访问、网站上是否有名称、网站上是否有电话、域名年龄、电话号码格式）。
• business_details（$0.08）：基于企业自有网站生成深度资料：抓取最多 5 个相关页面（菜单、服务、价格、营业时间、联系信息、预订），并返回机器可读资料，包括摘要、营业时间（OSM 语法）、带价格的服务、预订渠道、付款方式、语言和社交链接。
• business_shortlist（$0.25）：为委托人即将推出或收购项目的 Agent 寻找资源：描述需求（“在 Monterrey 开设咖啡品牌，需要包装供应商和设计师”），即可获取真实企业的排名名单，其中包含推荐理由、匹配度评分、最佳联系渠道、官方登记机构提供的员工规模、验证级别，以及经过筛选时提供的网站摘要。
• list_service（$1）：为你的 x402 端点、远程 MCP 服务或 A2A Agent 购买经过验证的列表——由 Agent 使用 USDC 付款，无需人工参与。
• forge_tool（$0.25）：根据描述、输入架构和测试示例创建新工具。
• do（$0.02）：一个端点处理所有需求（类似 OpenRouter）：描述你的需求并传入输入；Toll402 会从整个目录（内置工具、社区打造的工具、外部 x402 服务）中挑选最佳工具并运行。

社区锻造（示例）

• github_repo_stats ($0.003)：通过 https://api.github.com/repos// 获取 GitHub 仓库的星标数、复刻数、未解决议题数、许可证和最近推送时间。
• ip_geolocate ($0.002)：通过 https://ipapi.co//json/ 获取 IPv4/IPv6 地址对应的国家、地区、城市、时区和 ASN。
• hn_top ($0.005)：通过 https://hacker-news.firebaseio.com/v0/topstories.json 和 /v0/item/.json 获取 Hacker News 排名前 N 的故事（标题、网址、得分）。
• rss_latest ($0.003)：解析 RSS/Atom 源网址并返回最新的 N 条内容（标题、链接、发布时间）。
• npm_package_info ($0.003)：获取 npm 软件包的最新版本、描述、许可证、每周下载量（通过 api.npmjs.org）和主页。
• text_stats ($0.001)：统计文本的词数、句数、段落数、阅读时间（每分钟 200 词）和排名前 10 的关键词（已移除停用词）。
• url_status ($0.001)：获取网址的 HTTP 状态、最终内容类型和响应大小（先使用 HEAD，失败时回退到 GET）。
• wikipedia_summary ($0.002)：通过 https://.wikipedia.org/api/rest_v1/page/summary/ 获取维基百科主题的摘要摘录和规范网址。
• json_schema_validate ($0.001)：根据 JSON Schema 子集（type、properties、required、enum、minimum/maximum、minLength/maxLength、items）验证 JSON 值并返回。
• crypto_price ($0.002)：使用 https://api.coinbase.com/v2/prices/-USD/spot 获取加密资产符号对应的美元现货价格。
• jsonld_extract ($0.003)：获取公开网址，提取所有
• mst_vn_validate ($0.001)：用于越南企业/税号（Mã số thuế，MST）的离线结构验证器。
• partita_iva_validate ($0.001)：用于意大利 Partita IVA（增值税号）的离线验证器：验证值是否为 11 位数字，并重新计算类 Luhn 校验位。
• pan_in_validate ($0.001)：用于印度 PAN（永久账号）的离线验证器：将输入规范化为大写，检查是否符合 10 个字符的 AAAAA9999A 格式，并。
• siren_validate ($0.001)：用于法国 SIREN（9 位企业标识符）的离线验证器。
• cin_in_validate ($0.001)：用于印度 CIN（企业身份编号，21 个字符）的离线结构验证器。
• vat_fr_validate ($0.001)：用于法国增值税号（TVA intracommunautaire，例如）的离线验证器。
• cpr_dk_validate ($0.001)：用于丹麦 CPR-nummer（个人识别号码，格式为 DDMMYY-SSSS）的离线验证器/规范化工具。
• cvr_dk_validate ($0.001)：用于丹麦 CVR-nummer（由丹麦商业管理局颁发的 8 位企业注册号）的离线验证器。
• rrn_be_validate ($0.001)：用于比利时国家登记号码（Rijksregisternummer / Numéro de registre national，格式为 YYMMDDXXXCC）的离线验证器。

……还有 147 个锻造工具和 2,466 个服务提供商 API 端点（SEO、社交、信息增强、广告、市场数据、AI 生成）：访问 https://toll402.dev/catalog 浏览，或调用 find 并说明你的需求。

加入目录（付费刊登，面向 Agent 原生设计）

拥有 x402 端点、远程 MCP 服务或 A2A Agent？购买已验证的刊登（使用 x402 或积分），无需人工参与，也无需填写表单：先调用 POST https://toll402.dev/v1/listings/quote（免费实时验证 + 报价），然后通过任意 x402 客户端或使用你的积分密钥调用 POST https://toll402.dev/v1/listings。基础刊登每 30 天 $1 · 精选刊登每 30 天 $5。已刊登的服务在 /v1/find 和 /v1/do 路由器中的排名更高，并会显示在目录、llms.txt、Agent 卡片和着陆页中。仅在验证通过时收费。当前刊登：GET https://toll402.dev/v1/listings。