Quietforge x402 Tools

What Quietforge x402 Tools does

Quietforge x402 Tools MCP server provides a remote MCP interface for finding and evaluating pay-per-call x402 HTTP endpoints. Its directory includes services on Base, Solana, and other networks, with each result carrying details such as URL, method, network, USD price, recent usage, and probe data. The directory is health-checked and recrawled several times a day, so it is not a real-time market listing.

The server also exposes aggregate demand information based on on-chain USDC settlement on Base, a free price list for Quietforge’s own paid routes, and a Sudoku generator. Every MCP tool is free to call and does not require an account or API key.

How it works

The hosted endpoint uses streamable HTTP at https://qf-api.quietforge-studio.workers.dev/mcp. Requests are stateless: each POST is self-contained and does not require a session ID. The response format is JSON.

Directory metadata is aggregated from public Coinbase CDP Bazaar and PayAI discovery APIs. Quietforge supplies the crawl, probe, and uptime information. Its own endpoints may appear in search results with source=quietforge; those rows use the same per-host limits as other operators. Search ordering is based on 30-day usage, liveness, and freshness rather than operator ownership.

The demand tool measures settled Base USDC activity for seller addresses represented in the crawled index. It is a lower bound for the broader x402 market, not a complete market statistic.

Setup and configuration

Connect a streamable-HTTP-capable MCP client to the hosted URL. Claude Code can be configured with:

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

A client using MCP JSON configuration can use:

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

Clients that only support stdio, including Claude Desktop, need an mcp-remote bridge. No environment variables, account, or API key are required. The service logs tool names and the target host for probes; because the connection is stateless, it does not receive or store client identity.

Tools and capabilities

• x402_search searches the indexed x402 directory, with paging up to 100 rows.
• x402_service returns one indexed endpoint and its last 20 probe results, including status, latency, alive state, and calculated uptime.
• x402_index_stats reports index totals, currently responding endpoints, network and source counts, and crawl time.
• x402_demand reports recent aggregate Base USDC settlement, including sellers paid, total USD, and seller payment-count distribution.
• x402_probe makes one unpaid GET-style request to a public URL and checks for an x402 PAYMENT-REQUIRED challenge and parsed price.
• sudoku_puzzle creates one solver-verified Sudoku with a unique solution, 180-degree symmetry, a difficulty grade, and optional seed reproducibility.
• quietforge_pricing lists Quietforge paid x402 routes, their USD prices, payment address, network, and payment procedure.

Limitations and notes

Quietforge x402 Tools MCP server does not run as a standalone checkout from the repository. The repository contains the hosted tool module and registry manifest, while the larger FastAPI application, crawler, prober, and Sudoku generator are outside the repository.

x402_probe contacts a third-party public host and is not read-only. It follows public-host restrictions, rechecks redirects, avoids delisted hosts, caches results for 60 seconds, and limits probing to three requests per host per five minutes and 30 per minute overall. A valid challenge does not prove that the paid service will deliver usable output.

The directory is only a subset of the x402 ecosystem. x402_demand refuses to return snapshots older than 72 hours, and its seller and payer interpretation should not be treated as a complete customer count. Sudoku generation is shared across clients at 20 requests per minute. The repository code is licensed under MIT.