HTTP 402 AI Tollbooth

io.github.RobotFleet-HQPublished by GitHub account RobotFleet-HQv1.0.0Updated Oct 24, 2026

Free MCP troubleshooting-preview tools; purchases stay human-directed.

VerifiedStreamable HTTPWeb executableFinanceDeveloper ToolsData & Analytics

Overview

AI-generated overview

A remote MCP server that lets an assistant browse a catalog of developer troubleshooting datasets, preview three free records, and get Lightning payment steps.

What you can do
List the product catalog with categories, tiers, prices, item counts and endpoint paths, and list enabled payment rails with their public contracts. Preview exactly three free sample records for a product before any purchase. Return purchase directions and an HTTP 402 Lightning challenge for a product, without paying or completing a transaction.
When to use it
Useful when an assistant needs structured developer troubleshooting data such as error codes and fixes, and you want to sample it free before deciding whether to pay per dataset over Bitcoin Lightning.
Requirements
A remote Streamable HTTP endpoint; no accounts, API keys, credit cards or subscriptions are needed. Paying for full datasets requires a Bitcoin Lightning wallet and the payment hash and preimage headers on retry.
Before you install
Full datasets cost sats (2,000 to 10,000 per tier) and payment is human-directed; the buy tool only returns directions and never pays. A payment preimage is a secret that should not be shared before redemption. Requesting a paid endpoint creates an invoice, though it does not itself spend funds.

Installation

In SourceWeft

  1. Open HTTP 402 AI Tollbooth in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.RobotFleet-HQ%2Fhttp-402-ai-tollbooth/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "http-402-ai-tollbooth": {
      "type": "http",
      "url": "https://http-402-ai-tollbooth.rsaun-lightning.workers.dev/mcp"
    }
  }
}

README

HTTP 402 AI Tollbooth

Agent-ready developer troubleshooting data, sold per request over Bitcoin Lightning.

Live: https://http-402-ai-tollbooth.rsaun-lightning.workers.dev

HTTP 402 AI Tollbooth gives developers and AI agents three useful records free, then unlocks complete structured datasets with a BOLT11 Lightning payment. There are no accounts, subscriptions, credit cards, or API keys.

This is a public, documentation and example repository. The production Worker implementation remains private and is not included here.

Try it now

List the complete catalog:

bash
curl -sS https://http-402-ai-tollbooth.rsaun-lightning.workers.dev/api/catalog

Preview exactly three records without payment:

bash
curl -sS https://http-402-ai-tollbooth.rsaun-lightning.workers.dev/api/preview/api-error-fixes

Request the full product and receive an HTTP 402 Lightning challenge:

bash
curl -i https://http-402-ai-tollbooth.rsaun-lightning.workers.dev/api/data/api-error-fixes

The last command creates an invoice. Do not run it unless you intentionally want a payment challenge; simply requesting it does not spend sats.

Why agents use it

  • 203 products across DevOps, APIs, ML/AI, Web/Frontend, and Databases
  • Entry, Standard, and Premium datasets with 50, 100, or 200 records
  • Exactly three free records per product for try-before-you-buy discovery
  • Stable error_code, description, and programmatic_fix fields
  • HTTP 402 and Bitcoin Lightning payments without user accounts
  • OpenAPI 3.1, MCP discovery metadata, and llms.txt
  • Deterministic fallback generation for resilient dataset delivery
  • Durable one-time redemption and replay protection
  • Future x402 settlement is documented but remains disabled pending verification

Architecture

text
AI agent / developer        |        | HTTPS: catalog, preview, paid dataset        vCloudflare Worker   |         |                    |   |         |                    +--> Alby --> Bitcoin Lightning invoice   |         |   |         +--> Durable Objects --> atomic redemption + counters   |   +--> Workers KV --> invoice challenges + generated dataset cache

Pricing

TierPriceRecords
Entry2,000 sats50
Standard5,000 sats100
Premium10,000 sats200

See the pricing rationale, including the live-verified 2,000-sat receiving floor.

How to pay

  1. Request a paid product endpoint.
  2. Receive 402 Payment Required with a BOLT11 invoice and payment hash.
  3. Pay the invoice in a Lightning wallet.
  4. Retry the same endpoint with X-Payment-Hash and X-Payment-Preimage.
  5. Receive the full dataset once; replayed proofs are rejected.

Never publish or share a payment preimage before using it for its intended redemption. Future Solana USDC/x402 support is disabled until its manual verification process is completed.

Discovery documents

Integrations

  • MCP metadata: tool descriptions for catalog, preview, and purchase discovery
  • MCP transport: a live Streamable HTTP JSON-RPC endpoint at /mcp with four read-only tools
  • OpenAPI: complete HTTP endpoint descriptions for agent frameworks
  • LLMs.txt: concise machine-readable project and payment guidance

Connect an MCP client to https://http-402-ai-tollbooth.rsaun-lightning.workers.dev/mcp. The server supports list_products, preview_product, list_payment_methods, and buy_product. The last tool only returns payment directions and an HTTP 402 challenge; it never pays an invoice or creates a purchase on the caller's behalf.

For a complete no-payment example, see the Node agent recovery sample.

Runnable free sample

The sample shows how an agent can inspect malformed JSON, retry a transient 429 once after Retry-After, and safely stop when a response is not recoverable. It uses Node 22+ built-ins only:

bash
cd examples/node-agent-recoverynpm testnpm start

The demo calls only the public three-record preview endpoint. It does not call a paid route, create an invoice, or automatically replay a payment proof.

License

The documentation in this billboard repository is available under the MIT License. The private production source code is not covered by this repository or license.

Source: README.md at commit 32e2fa8

Tools

4

list_products

List all products, categories, tiers, prices, item counts, and endpoint paths.

Takes no parameters.

preview_product

Get exactly three free sample records before purchase.

Parametersproductrequired

list_payment_methods

List the currently enabled payment rails and their public machine-readable contracts.

Takes no parameters.

buy_product

Return purchase directions for a product without initiating or paying a transaction.

Parametersproductrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts