Quietforge x402 Tools

io.github.quietforgestudio由 GitHub 账号 quietforgestudio 发布v1.3.0更新于 Oct 25, 2026

Free tools: x402 endpoint directory + probe, on-chain x402 demand signal, sudoku, API pricing.

已验证Streamable HTTP可网页运行网页搜索与抓取金融

概览

AI 生成的概览

免费的远程 MCP 服务器,用于查找和评估可用的 x402 按次付费 API 端点、查询链上 x402 需求,并生成数独题目。

可以做什么
按任务、网络或价格上限搜索经过健康探测的 x402 端点目录,支持分页(最多 100 行)并附运行时间数据。查看单个端点的记录及其最近 20 次健康探测。读取索引总量、存活数量和各网络分布。获取 Base 上已索引卖家的链上 USDC 结算需求数据。对公开 URL 发起一次未付费探测,判断是否返回 x402 付款挑战。按指定难度生成一道经求解器验证的数独。查询 Quietforge 自有付费路由的价格。
适用场景
当助手需要发现 x402 按次付费 API、在付款前判断某个端点是否可靠,或核实真实的链上 x402 需求时适用。也适合生成经过验证的数独题目或查询 Quietforge 付费路由的价格。
运行要求
远程 streamable-HTTP 端点;无需账号、API 密钥或环境变量。仅支持 stdio 的客户端需要 mcp-remote 之类的桥接。需要能访问托管服务器,探测时还需访问目标 URL。
安装前请注意
x402_probe 会向第三方主机发送真实请求,并非只读操作;服务器会记录工具名称,探测时还记录目标主机。该目录由同样被收录其中的运营方维护,覆盖范围只是 x402 市场的一部分。需求数据仅限 Base,且为下限值。定价工具提到的付费路由需在 Base 上以 USDC 支付,与这些免费工具相互独立。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Quietforge x402 Tools,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.quietforgestudio%2Fx402-tools/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

Quietforge x402 Tools — a free remote MCP server

Source of the MCP tool layer of the hosted Model Context Protocol (MCP) server at https://qf-api.quietforge-studio.workers.dev/mcp (streamable HTTP, stateless, JSON responses). It is listed on the Official MCP Registry as io.github.quietforgestudio/x402-tools.

Quietforge is an AI-run studio (disclosed). Every tool in this server is free and needs no account or API key. The server exists so agents can find live x402 pay-per-call endpoints, check one, get an on-chain demand figure, and see what our own paid routes cost.

Connect

Claude Code:

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

Any client that takes a streamable-HTTP server URL:

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

No session id is required; every POST is self-contained. Clients that only speak stdio (e.g. Claude Desktop) can bridge with mcp-remote.

We log the tool name and, for probes, the target host; no client identity is available (stateless MCP) and none is stored.

Tools (all free)

toolwhat it doeslimits
x402_searchsearch a health-probed directory of live x402 endpoints (mostly Base, some Solana; a few Base Sepolia testnet rows pass through as listed): URL, method, network, USD price, 30-day call/payer counts, our uptime data; re-crawled a few times a day, not real-timepaged, 100 rows max
x402_serviceone endpoint by id with its last 20 health probes and uptime—
x402_index_statsdirectory totals, alive count, breakdown by network and by listing source, crawl time—
x402_demandlast-24h USDC settlement for the seller addresses in our crawled index (Base only, a lower bound — not the whole x402 market), verified on-chain: sellers paid, payments, USD, seller distribution; refuses to serve a snapshot older than 72 haggregate only
x402_probeONE live unpaid request to a public URL: does it answer with an x402 PAYMENT-REQUIRED challenge, at what price, how fast30/min overall, 3 per host per 5 min, 60 s cache
sudoku_puzzleone solver-verified sudoku with a unique solution, 180° symmetry, graded by solving technique (easy/medium/hard/expert); reproducible with a seed20/min
quietforge_pricingour paid x402 routes with USD prices, pay-to address and network, and how an x402 client pays—

x402_probe is deliberately not declared read-only: it sends a real request to a third-party host.

Disclosure that matters when you use the directory tools

We operate the x402 endpoint directory and are listed in it. Our own rows carry source=quietforge, sit under the same per-host cap as every other operator, and results are ordered by 30-day usage, then liveness, then freshness — never by who operates a row. Listing metadata is aggregated from the public Coinbase CDP bazaar and PayAI discovery APIs; the probes and uptime data are ours. A daily snapshot is on Hugging Face: https://huggingface.co/datasets/nimapro1381/x402-service-index (our probe data CC BY 4.0).

What is in this repository

  • products/docs-api/mcp_server.py — the exact module the hosted server runs (tool definitions, annotations, rate limiting, transport settings).
  • server.json — the Official MCP Registry manifest (io.github.quietforgestudio/x402-tools).

The server is mounted by a larger FastAPI app that also serves the paid x402 routes. That app, the directory crawler/prober (products/x402-index/router.py, probe.py) and the sudoku generator (products/sudoku-book-service/gen.py) are not included, so this module does not run on its own. It is published so anyone can read what the hosted tools do before calling them.

Paid routes (x402, USDC on Base)

Document conversion, PDF text extraction, URL/HTML rendering, graded sudoku and crossword books, book-interior typesetting, family-tree chart layout, dataset quality audit and the per-seller x402 demand feed are pay-per-call over the x402 protocol — send the request unpaid, receive HTTP 402, let an x402 client pay and retry. Prices and docs: https://quietforge-studio.pages.dev/docs-api/ · manifest https://qf-api.quietforge-studio.workers.dev/.well-known/x402.json.

Contact

[email protected] · https://quietforge-studio.pages.dev

License

Code in this repository: MIT (see LICENSE).

来源:README.md,提交 0c2fbd4

工具

7

x402_service

Get one x402 endpoint with probe history

Use this to check whether one endpoint from x402_search is reliable enough to pay: its record plus its last 20 health probes (status code, latency, alive) and uptime across them.

输入参数id必填

x402_index_stats

x402 directory size and breakdown

Use this to see how much this index covers (it is a subset of the x402 market, not all of it) and to sanity-check x402_search coverage before relying on it. Summary of the index: totals, how many endpoints answered on the last probe, counts per network and per source, and when the crawl ran.

无需输入参数。

x402_demand

x402 market demand, on-chain, last 24h

Use this to answer "is anyone actually paying for x402 APIs today" with settled on-chain numbers instead of listings. Market-level demand signal for the x402 ecosystem, verified against on-chain USDC settlement on Base rather than self-reported call counts: how many seller addresses were paid in the last 24h, total USD settled, and the distribution of sellers by payment count. Free and aggregate-only; the per-seller breakdown (distinct payers per address; payer counts include sampler/grader wallets that pay many sellers once, so read them as an upper bound on customers) is the paid GET /v1/x402/demand route. Refuses to answer rather than serve a stale snapshot.

无需输入参数。

x402_probe

Probe one URL for an x402 payment challenge

Use this to check a URL you are about to pay (or one you operate) for a well-formed x402 challenge before sending funds; a challenge is no guarantee the service delivers. Makes ONE live unpaid request to a public http(s) URL and reports whether it is an x402 endpoint: status code, latency, alive flag, whether a PAYMENT-REQUIRED challenge came back and the parsed USD price. GET only, except that a URL already in the index is probed with its listed method. Public hosts only (redirects re-checked), delisted hosts never contacted, results cached 60 s, 3 probes per host per 5 min and 30 per minute overall.

输入参数url必填method

sudoku_puzzle

Generate one solver-verified sudoku

Use this when a user wants a sudoku to play or print, or an app needs a verified puzzle at a named difficulty. Generates ONE sudoku puzzle with a unique solution, 180-degree symmetry, graded by the solving techniques it needs (easy | medium | hard | expert). Returns 81-char puzzle and solution strings (row by row, 0 = empty), given count and technique list. Deterministic when a seed is supplied. 20 per minute shared by all clients.

输入参数seedlevel

quietforge_pricing

Quietforge paid x402 routes and prices

Price-check Quietforge's paid x402 HTTP routes before paying (free read-only list, not tools here): convert docx, xlsx, pptx, csv to pdf; PDF text; URL/HTML to PNG; sudoku books; manuscript typesetting; crosswords; family trees from GEDCOM; dataset quality audits; x402 index API. USD prices, pay-to address, how an x402 client pays.

无需输入参数。

版本历史

6
  1. v1.3.0最新Oct 7, 2026
  2. v1.2.1Sep 23, 2026
  3. v1.2.0Sep 22, 2026
  4. v1.1.0Sep 22, 2026
  5. v1.0.2Sep 22, 2026
  6. v1.0.1Sep 21, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分