Skip to main content
Glama

Agent Tollbooth 402

Monetize APIs, Cloudflare Workers, Hono apps, Next.js routes, and MCP servers in under 60 seconds with dual-rail HTTP 402 payments.

Built by Red Center Studio for Google Antigravity and Claude Code.

Red-Center-Studio/agent-tollbooth-402 MCP server Agent Tollbooth 402 MCP Connector MCP Endpoint Live Clearinghouse License: MIT


3-Line Quickstart (30-Second Zero-Config Sandbox)

npm install
npm run validate
npm run test:sandbox

Zero API keys, zero crypto wallets, and zero Stripe setup required to run your first 402 -> sign -> 200 OK loop locally.


Related MCP server: Loop MCP DualRail

5-Line withTollbooth Setup

Copy-paste into any Cloudflare Worker, Web Fetch handler, or Next.js route:

import { withTollbooth } from "@redcenterstudio/agent-tollbooth-edge";

export default withTollbooth({ priceUsd: 0.01, mode: "hybrid" }, async (request) => {
  return Response.json({ ok: true, path: new URL(request.url).pathname });
});
  • Local test without wallets or keys: change mode: "hybrid" to mode: "sandbox" and call createSandboxReceipt() or createSandboxX402Header().

  • Hono middleware: app.use("/api/*", honoTollbooth({ priceUsd: 0.01, mode: "hybrid" })).

  • Cloudflare D1 replay protection: pass nonceStore: new D1NonceStore(env.DB) inside withTollbooth((env) => ({ ... }), handler).


Live Clearinghouse & Screenshots

Live clearinghouse portal & MCP endpoint: https://tollbooth.redcenterstudio.com (/pay · /demo/402)

Clearinghouse Setup & 4-Tier Portal

HTTP 402 Browser Checkout Card

Mobile Responsive Layout (390px)

HTTP 402 Checkout Card

Mobile Clearinghouse View


Dual-Rail Architecture & Browser 402 Checkout Card

agent-tollbooth-402 supports both x402 V2 on-chain USDC authorizations and Red Center Fiat Agent Wallets verified in <1ms via Web Crypto (HMAC-SHA256 / Ed25519).

  • Programmatic AI Agents (Accept: application/json): Receive 402 Payment Required with Base64 PAYMENT-REQUIRED, WWW-Authenticate, CORS Access-Control-Expose-Headers, priceUsd, acceptedRails, code, and a plain-English fix_hint.

  • Human Browser Requests (Accept: text/html): Receive a responsive Red Center Studio 402 Checkout Card (#24181a Ironstone, #d9622b Red Ochre, #e3a23c Spinifex Gold, #f5efe6 Sand) displaying endpoint details, price, payment curl snippets, and a Fund Agent Wallet action link.

flowchart LR
    Agent["AI Agent / Browser"] -->|1. Request API or /mcp| Edge["@redcenterstudio/agent-tollbooth-edge"]
    Edge -->|2. Unpaid -> 402 JSON or HTML Card| Agent
    Agent -->|3A. Rail A: PAYMENT-SIGNATURE x402 V2| Edge
    Agent -->|3B. Rail B: Bearer rcs_receipt_... <1ms Web Crypto| Edge
    Edge -->|4A. /verify & /settle| Facilitator["Clearinghouse Worker / Facilitator"]
    Edge -->|4B. HMAC-SHA256 / Ed25519 + D1 used_nonces| NonceDB[("Cloudflare D1")]
    Facilitator -->|Atomic Debit & Ledger| NonceDB
    Edge -->|5. 200 OK + PAYMENT-RESPONSE| Agent

Pricing & Revenue Split

Tier

Price

Clearinghouse Fee (Developer Net)

What You Get

Free / BYO x402 Mode

$0

0% (100% net)

Unlimited /agent-tollbooth-402:scan-routes, zero-dependency middleware injection, /agent-tollbooth-402:test-agent simulator, exact x402 V2 scheme with any facilitator.

Hybrid Fiat + x402 Clearinghouse

$0/mo

7% (93% net)

Enables Stripe-funded Fiat Agent Wallets (rcs_receipt_... <1ms edge verification) + automated Stripe Connect payouts via tollbooth.redcenterstudio.com.

Tollbooth Pro Pass

$39 one-time ($79 Agency)

3% (97% net)

Drops clearinghouse fee from 7% to 3%, unlocks upto dynamic per-token/per-KB metering, custom HTML 402 pages, and per-agent spend caps.

Done-For-You Integration

From $399

Custom

End-to-end custom MCP + HTTP 402 Tollbooth wrapping, D1 ledger setup, and verification by Red Center Studio.


Plugin Installation (Antigravity + Claude Code)

Install in Claude Code:

/plugin install agent-tollbooth-402 --marketplace Red-Center-Studio/agent-tollbooth-402

Install in Antigravity (~/.gemini/config/plugins/):

git clone https://github.com/Red-Center-Studio/agent-tollbooth-402.git ~/.gemini/config/plugins/agent-tollbooth-402

Install the zero-dependency Edge Middleware in a Worker, Hono, or Next.js project:

npm install github:Red-Center-Studio/agent-tollbooth-402
  • Remote MCP Server (mcp_config.json & .mcp.json): Connects to https://tollbooth.redcenterstudio.com/mcp via Streamable HTTP (tollbooth_pricing_quote, tollbooth_wallet_balance, tollbooth_issue_receipt, tollbooth_verify_x402). See our Privacy Policy.

  • Skills (skills/):

    • scan-routes: Audits Cloudflare Workers, Hono, Next.js App Router, Express, and MCP endpoints.

    • install-tollbooth: Auto-detects framework, previews diff, and injects 1-step withTollbooth(...).

    • test-agent: Runs the 30-second zero-config sandbox 402 -> sign -> 200 OK smoke test.

  • Scoped Guardrails (rules/http-402-guardrails.md): Enforces bypass exemptions, constant-time Web Crypto checks, replay protection, downstream 5xx idempotency, integer microdollar math, and spend caps.


Troubleshooting FAQ

Error Code

Meaning

Fix (fix_hint)

MISSING_PAYMENT

Request had neither PAYMENT-SIGNATURE nor Bearer rcs_receipt_....

Attach an x402 V2 PAYMENT-SIGNATURE header, a Rail B receipt, or use createSandboxReceipt() in mode: "sandbox".

INSUFFICIENT_FUNDS

Payment authorization or wallet balance is below priceMicros.

Authorize at least priceMicros atomic units or top up the agent wallet balance.

RECEIPT_EXPIRED

exp / iat / validBefore fell outside the +/-30s clock-skew window.

Re-sign a fresh receipt or x402 authorization using synchronized UTC seconds.

NONCE_REPLAYED

The receipt jti or x402 nonce was already consumed in used_nonces.

Generate a new unique crypto.randomUUID() nonce/receipt for every new paid request.

INVALID_SIGNATURE

Web Crypto HMAC/Ed25519 verification failed, or aud / payTo / network mismatched.

Confirm RECEIPT_SIGNING_SECRET, ed25519PublicKey, payTo, and target URL match.

Browser CORS blocked reading headers

Browser client cannot read PAYMENT-REQUIRED or PAYMENT-RESPONSE.

Middleware automatically sets Access-Control-Expose-Headers: PAYMENT-REQUIRED, PAYMENT-RESPONSE, X-Agent-Receipt, WWW-Authenticate, X-Tollbooth-Rail.

Reference Clearinghouse Note (packages/clearinghouse-worker): Includes placeholder D1 IDs (wrangler.jsonc) and .dev.vars.example placeholders. Supply your own D1 database and Wrangler secrets before deploying to your own Cloudflare account.


License

MIT — Red Center Studio (https://redcenterstudio.com)

Available Tools

5 tools
tollbooth_create_topup_checkoutGenerate Checkout Link URLA
Read-onlyIdempotent
Inspect

Return a Stripe Checkout or sandbox link URL that a user can open in a browser to fund a wallet ($1+) or purchase a Pro ($39) / Agency ($79) Pass. Never charges automatically.

Inputs: passTier, walletId, amountUsd, developerId.

tollbooth_issue_receiptIssue Signed Bearer ReceiptAInspect

Issue a short-lived Rail B rcs_receipt_hs256 bearer authorization token against an existing prepaid credit balance. Does not move bank or crypto funds.

Inputs: audience (required), walletId (required), developerId (required), amountMicros (required), +3 more.

tollbooth_pricing_quotePricing & Net Revenue QuoteA
Read-onlyIdempotent
Inspect

Compute clearinghouse fee and developer net payout across Free BYO x402 (0%), Hybrid (7%), and Tollbooth Pro/Agency (3%) tiers in integer USD microdollars.

Inputs: priceMicros (required), callsPerMonth (required).

tollbooth_verify_x402Verify x402 V2 Payment HeaderA
Read-onlyIdempotent
Inspect

Verify an x402 V2 paymentPayload signature and expiry against paymentRequirements and replay records. Does not execute on-chain transfers.

Inputs: x402Version (required), paymentPayload (required), paymentRequirements (required).

tollbooth_wallet_balanceCheck Wallet Credit BalanceA
Read-onlyIdempotent
Inspect

Inspect an agent wallet credit balance, status, and remaining UTC daily spend cap. Read-only lookup.

Inputs: walletId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct stage of the payment lifecycle: quoting, balance lookup, receipt issuance, inbound x402 verification, and top-up checkout. The descriptions explicitly bound each tool (read-only, does not move funds, never charges automatically), so there is no realistic risk of misselection.

    Naming Consistency4/5

    All tools share the tollbooth_ prefix and snake_case, giving a predictable namespace. Three follow verb_noun (issue_receipt, verify_x402, create_topup_checkout) while two are noun_noun (pricing_quote, wallet_balance), a minor deviation that remains readable.

    Tool Count5/5

    Five focused tools covering quote, inspect, authorize, verify, and fund is well-scoped for a payment-authorization service. Each tool earns its place with no redundant or filler operations.

    Completeness4/5

    The core loop (quote → fund → check balance → issue receipt → verify payment) is covered end to end. Minor gaps exist: no way to introspect or revoke an issued receipt, and no spend/usage history beyond a point-in-time balance.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to pay for MCP tool calls using either Bitcoin/Lightning (L402) or USDC (x402) rails, with unified settlement and a 21% discount for Bitcoin payments.
      32 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Non-custodial payment engine for AI agents supporting BTC, ETH, USDT, USDC, XRP, XMR, and ZEC. Exposes wallet, invoice, and payment tools over MCP with per-agent spend limits, plus x402 pay-per-call support.
      62 npm
      Business Source 1.1