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 分