Quietforge x402 Tools

Name: Quietforge x402 Tools
Author: quietforgestudio

远程服务

quietforge-studio.pages.dev开发工具05 周前更新

代码仓库访问官网

关于 Quietforge x402 Tools

Quietforge x402 Tools 是供 Agent 探索 x402 服务的免费托管 MCP 服务，涵盖端点搜索与探测、链上需求数据、数独生成，以及 Quietforge 路由定价查询。

主要功能

01搜索经过健康探测的 x402 目录
02查看端点探测记录和在线率
03查看索引范围内的链上需求
04探测公开端点的支付条件
05生成经求解验证的数独题
06查询 Quietforge 路由价格

适用场景

01查找在线 x402 服务并比较其条款
02查看某服务近期的健康探测记录
03估算索引范围内的 Base USDC 结算活动
04测试公开 URL 是否返回 x402 支付挑战

MCP 相关

托管的 Streamable HTTP MCP 服务提供七种免费工具，用于搜索和查看 x402 端点、探测 URL、查询需求、生成数独题及查看 Quietforge 定价。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://qf-api.quietforge-studio.workers.dev/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http quietforgestudio-x402-tools https://qf-api.quietforge-studio.workers.dev/mcp

Cursor.cursor/mcp.json{"mcpServers":{"quietforgestudio-x402-tools":{"type":"http","url":"https://qf-api.quietforge-studio.workers.dev/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"quietforgestudio-x402-tools":{"type":"http","url":"https://qf-api.quietforge-studio.workers.dev/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"quietforgestudio-x402-tools":{"type":"http","url":"https://qf-api.quietforge-studio.workers.dev/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"quietforgestudio-x402-tools":{"serverUrl":"https://qf-api.quietforge-studio.workers.dev/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
q	string	否	对资源 URL、描述和服务名称执行不区分大小写的子串匹配；不提供则不按文本筛选。
alive	boolean	否	true = 在我们上次探测时其付费路由有响应；false = 无响应；省略则包括两者。
limit	integer	否	分页大小，1–100；超出范围的值会被限制在有效范围内。
offset	integer	否	分页时要跳过的行数；负数按 0 处理。
source	string	否	列表来源：cdp（Coinbase CDP bazaar）、payai（PayAI discovery）或 quietforge（自有端点）；省略则包括所有来源。
network	string	否	用于筛选的 CAIP-2 网络 ID，例如 eip155:8453（Base 主网）；省略则包括所有网络。
max_price_usd	number	否	仅包含每次调用价格不高于此美元金额的端点；不限制价格则省略。

详细介绍

Quietforge x402 工具 — 免费的远程 MCP 服务

托管的 Model Context Protocol (MCP) 服务中 MCP 工具层的源码，服务地址为 https://qf-api.quietforge-studio.workers.dev/mcp（可流式 HTTP、无状态、返回 JSON）。该服务已收录在官方 MCP Registry，名称为 io.github.quietforgestudio/x402-tools。

Quietforge 是一家由 AI 运营的工作室（已披露）。此服务中的所有工具均免费使用，无需账户或 API 密钥。该服务旨在让 Agent 能够发现实时的 x402 按次付费端点、检查端点、获取链上需求数据，并了解我们自有付费路由的费用。

连接

Claude Code：

claude mcp add --transport http quietforge https://qf-api.quietforge-studio.workers.dev/mcp

任何支持可流式 HTTP 服务 URL 的客户端：

{ "mcpServers": { "quietforge": { "type": "http", "url": "https://qf-api.quietforge-studio.workers.dev/mcp" } } }

无需会话 ID；每个 POST 请求都独立处理。仅支持 stdio 的客户端（例如 Claude Desktop）可通过 mcp-remote 进行桥接。

我们会记录工具名称；对于探测请求，还会记录目标主机。由于 MCP 无状态，我们无法获取客户端身份，也不会存储该信息。

工具（全部免费）

工具	功能	限制
`x402_search`	搜索经过健康状态探测的实时 x402 端点目录（大多位于 Base，部分位于 Solana；还会按原样收录少数 Base Sepolia 测试网条目）：URL、方法、网络、美元价格、30 天调用次数和付款方数量、我们的正常运行时间数据；每天重新抓取数次，并非实时	分页，每页最多 100 条
`x402_service`	根据 ID 查询单个端点及其最近 20 次健康状态探测和正常运行时间	—
`x402_index_stats`	目录总数、存活数量、按网络和收录来源分类的统计数据、抓取时间	—
`x402_demand`	我们抓取的索引中卖家地址过去 24 小时的 USDC 结算情况（仅限 Base，是下限，并非整个 x402 市场）；数据经链上验证：已付款卖家、付款次数、美元金额、卖家分布；若快照超过 72 小时则拒绝提供	仅提供汇总数据
`x402_probe`	向公开 URL 发起一次真实的免费请求：检查其是否返回 x402 `PAYMENT-REQUIRED` 挑战、价格和响应速度	总计每分钟 30 次；每个主机每 5 分钟 3 次；缓存 60 秒
`sudoku_puzzle`	生成一个经求解器验证、具有唯一解且呈 180° 对称的数独，并按解题技巧分级（简单／中等／困难／专家）；可通过种子复现	每分钟 20 次
`quietforge_pricing`	我们的付费 x402 路由、美元价格、收款地址和网络，以及 x402 客户端的付款方式	—

x402_probe 特意未声明为只读：它会向第三方主机发送真实请求。

使用目录工具时需要了解的披露信息

我们既运营 x402 端点目录，也在其中收录了自己的端点。我们自有条目的来源标记为 source=quietforge，与所有其他运营方遵循相同的单主机调用上限；结果按 30 天使用量、存活状态和新鲜度排序，绝不按条目运营方排序。收录元数据汇总自 Coinbase CDP bazaar 和 PayAI discovery API；探测和正常运行时间数据由我们提供。Hugging Face 上提供每日快照： https://huggingface.co/datasets/nimapro1381/x402-service-index（我们的探测数据采用 CC BY 4.0 许可）。

此仓库包含的内容

products/docs-api/mcp_server.py — 托管服务运行的确切模块（工具定义、注释、速率限制、传输设置）。
server.json — 官方 MCP Registry 清单（io.github.quietforgestudio/x402-tools）。

该服务由一个更大的 FastAPI 应用挂载，该应用也提供付费 x402 路由。此应用、目录爬取器／探测器（products/x402-index/router.py、probe.py）以及数独生成器（products/sudoku-book-service/gen.py）均未包含，因此此模块无法独立运行。发布此模块是为了让任何人都能在调用托管工具之前了解其功能。

付费接口（x402，Base 上的 USDC）

文档转换、PDF 文本提取、URL/HTML 渲染、带难度分级的数独和填字游戏题集、书籍内页排版、家谱图表布局、数据集质量审计，以及按卖家划分的 x402 需求动态，均通过 x402 协议按次付费——发送未付款请求，收到 HTTP 402 后，由 x402 客户端付款并重试。价格和文档： https://quietforge-studio.pages.dev/docs-api/ · 清单 https://qf-api.quietforge-studio.workers.dev/.well-known/x402.json。