GPT-5.5 x402 Gateway MCP Server

Puerta de enlace MCP HTTP transmisible remota para el chat GPT-5.5 más 92 herramientas de texto, web, JSON y descubrimiento x402 con pago por llamada en Base USDC.

GitHub

Documentación

GPT-5.5 x402 Gateway

Remote MCP and GPT-5.5 gateway with x402 Base USDC settlement, wallet signing safety, approval-risk auditing, paid seller-intelligence, merchant-readiness checks, and buyer-ready API audit tools for agents.

The service is built for agent buyers that need low-cost GPT-5.5 calls, deterministic utility tools, wallet signing safety checks, x402 prepayment risk checks, and ready-to-use x402/MCP/Bazaar integration resources.

Start Here

  • Buyer agent, MCP client, wallet UI, or x402 seller trying to move from quote probes to a real first purchase: start with examples/agent-payment-launchpad/. It checks wallet safety, MCP integration, and seller mini-check routes in one quote-only run, verifies amount/network/payTo, and stops before payment.
  • Seller/operator trying to understand why x402 quotes are not turning into paid calls: run examples/checkout-dropoff-summary/ to separate quote-only traffic from payment-header, verify, and settle events. It is read-only and never signs or pays.
  • Buyer agent looking for the lowest-friction first paid tool that already has verified external settlement: start with https://gpt55.558686.xyz/x402/translate-first-purchase, then run examples/translate-first-purchase/ to quote /v1/tools/translate without signing or paying.
  • Buyer agent or MCP client that already has a live 402 quote but needs a final allow/deny rule before wallet-owned payment: run examples/agent-payment-risk-gate/ to check status, amount, network, payTo, spend cap, and receipt evidence without paying.
  • Wallet buyer evaluating wallet-signing-safety-pack: inspect https://gpt55.558686.xyz/x402/wallet-prepay-first-purchase.json field firstPurchaseCheckoutContract.livePaymentChecklist, then run npm run wallet-checkout:contract and the quote-only first-payment client before any private key or payment is involved.
  • Agent, wallet, or MCP buyer trying to safely move from quote probes to a real first payment: start with the Agent Payment Safety Control Plane at https://gpt55.558686.xyz/x402/agent-payment-safety-control-plane, then run examples/agent-payment-safety-control-plane/ to verify route, spend cap, payTo, network, and expected receipt fields without paying.
  • Buyer agent that already received a paid tool result with x402NextPurchase: run examples/x402-next-purchase-router/ to select the next wallet-safety or MCP route, enforce the 0.02 USDC cap, and stop before payment.
  • Buyer that needs the broader discovery and checkout map: use the Agent Payment Control Plane at https://gpt55.558686.xyz/x402/agent-payment-control-plane, then run examples/agent-payment-control-plane/ to inspect route selection and quote policy without paying.
  • Agent buyer that needs a machine-readable payment allowlist before any real spend: run examples/agent-payment-policy-manifest/ to check live 402 quotes against route, budget, payTo, and network policy without signing or paying.
  • Content site, docs site, API publisher, or MCP service trying to monetize AI crawler/agent traffic: start with the AI Crawler Monetization Kit at https://gpt55.558686.xyz/x402/ai-crawler-monetization-kit, then run examples/ai-crawler-monetization-kit/ to generate protected routes, x402 discovery copy, robots.txt, llms.txt, edge-worker notes, and a launch checklist.
  • Buyer unsure which x402 route to buy first: start with the First Purchase Router at https://gpt55.558686.xyz/x402/first-purchase-router, then run examples/first-purchase-router/ to verify the live quote without paying.
  • Agent or wallet buyer evaluating paid x402 endpoints: start with the Buyer Conversion Suite at https://gpt55.558686.xyz/x402/buyer-conversion-suite, then use examples/buyer-conversion-suite/ to choose the safest first paid URL without paying.
  • Agent payment integrator: use the Agent Commerce Suite at https://gpt55.558686.xyz/x402/agent-commerce-suite, load the buyer payment policy at https://gpt55.558686.xyz/x402/buyer-payment-policy-pack.json, then use examples/buyer-payment-policy-pack/, examples/agent-commerce-suite/, or examples/agentcore-mcp-buyer-quickstart/ to decode the first live quote without paying. After paying the first decision endpoint, read buyerAgentPaymentDecision, agentPolicyInputs, and receiptEvidenceRequiredAfterPayment before any target payment.
  • Agent/MCP buyer trying to move from quote to first payment: start with the Agent Payment Readiness Lab at https://gpt55.558686.xyz/x402/agent-payment-readiness-lab, then run examples/agent-payment-readiness-lab/ to quote first-purchase routes without paying.
  • Wallet or agent buyer choosing the first safety purchase: start with https://gpt55.558686.xyz/x402/wallet-prepay-first-purchase, then run examples/wallet-prepay-first-purchase/ to quote wallet/prepay routes without paying.
  • Agent or MCP buyer ready for checkout: start with https://gpt55.558686.xyz/x402/agent-checkout-kit, then run examples/x402-first-payment-client/ in quote-only mode for either wallet-signing-safety-pack or mcp-integration-kit.
  • Buyer ready to move from quote to a real first payment: use examples/x402-first-payment-client/ in quote-only mode first. Lowest-cost settlement canary is ROUTE_ID=translate-canary MAX_USDC=0.001; after that works, upgrade to wallet-signing-safety-pack with MAX_USDC=0.02 or mcp-integration-kit.
  • Buyer or agent that already paid and needs proof before trusting the result: use the x402 Receipt Verifier at https://gpt55.558686.xyz/x402/receipt-verifier, then run examples/receipt-verifier/ to recompute receiptHash, actionRef, payTo, network, amount, route, and transaction evidence without signing or paying.
  • Paying or signing with an agent wallet: start with https://gpt55.558686.xyz/x402/wallet-signing-risk-kit.
  • Checking a paid x402 endpoint before spending USDC: start with https://gpt55.558686.xyz/x402/prepay-trust-check.
  • Reviewing standing approvals before treasury actions: start with https://gpt55.558686.xyz/x402/approval-risk-auditor.
  • Selling an x402 or paid MCP API: start with https://gpt55.558686.xyz/x402/merchant-readiness, quote https://gpt55.558686.xyz/v1/paid/x402-seller-mini-check for the lowest-friction $0.006 first paid check, then buy https://gpt55.558686.xyz/v1/paid/x402-growth-plan for the execution checklist or https://gpt55.558686.xyz/v1/paid/x402-seller-intel for the full bundle.
  • Directory or marketplace reviewer: use the GitHub Pages merchant-readiness brief at https://go165.github.io/gpt55-x402-gateway/merchant-readiness.html for copy-paste listing text and live quote steps.

For Buyers Ready To Pay

Start quote-only. These commands do not use a private key, do not sign, and do not pay:

curl -fsSLO https://gpt55.558686.xyz/x402/first-payment-client.mjs
npm install @x402/fetch viem
ROUTE_ID=wallet-signing-safety-pack MAX_USDC=0.02 node first-payment-client.mjs
npm run wallet-checkout:contract
ROUTE_ID=translate-canary MAX_USDC=0.001 node examples/x402-first-payment-client/first-payment-client.mjs
ROUTE_ID=wallet-signing-safety-pack MAX_USDC=0.02 node examples/x402-first-payment-client/first-payment-client.mjs
ROUTE_ID=mcp-integration-kit node examples/x402-first-payment-client/first-payment-client.mjs

The wallet checkout contract lives at https://gpt55.558686.xyz/x402/wallet-prepay-first-purchase.json under firstPurchaseCheckoutContract. It names the exact paid URL, amount 18000, network eip155:8453, payTo, payment gates, livePaymentChecklist, paid result fields, and post-payment guard examples.

For wallet-signing-safety-pack, the buyer-owned first-payment quickstart is:

git clone https://github.com/go165/gpt55-x402-gateway.git && cd gpt55-x402-gateway
npm install
ROUTE_ID=wallet-signing-safety-pack MAX_USDC=0.02 node examples/x402-first-payment-client/first-payment-client.mjs
cat examples/x402-first-payment-client/last-run.evidence.json
PAY_REAL_X402=1 ROUTE_ID=wallet-signing-safety-pack MAX_USDC=0.02 EVM_PRIVATE_KEY=0x... node examples/x402-first-payment-client/first-payment-client.mjs

The first-payment client starts quote-only. It should show paymentSent: false, the live amountAtomic, network, payTo, spend-cap checks, and buyerPaymentHandoff before the buyer opts into PAY_REAL_X402=1. Never send a private key, seed phrase, wallet password, exchange login, or custodial API key to the service.

The same client is also directly downloadable from the service at https://gpt55.558686.xyz/x402/first-payment-client.mjs, so buyers can run the first quote without cloning the full repository.

Only after the live quote matches amount, network, asset, and payTo, a buyer-owned wallet environment can opt in to a real x402 payment:

PAY_REAL_X402=1 ROUTE_ID=wallet-signing-safety-pack MAX_USDC=0.02 EVM_PRIVATE_KEY=0x... node examples/x402-first-payment-client/first-payment-client.mjs
PAY_REAL_X402=1 ROUTE_ID=translate-canary MAX_USDC=0.001 EVM_PRIVATE_KEY=0x... node examples/x402-first-payment-client/first-payment-client.mjs
PAY_REAL_X402=1 ROUTE_ID=mcp-integration-kit EVM_PRIVATE_KEY=0x... node examples/x402-first-payment-client/first-payment-client.mjs

Expected paid result shapes:

After a buyer-owned wallet payment, save x-x402-receipt-id and x-x402-receipt-url, then verify the receipt before trusting automated follow-up actions:

npm run receipt:verify -- --receipt-url https://gpt55.558686.xyz/x402/receipts/{receiptId}

Public Endpoints

  • Service: https://gpt55.558686.xyz
  • MCP Streamable HTTP: https://gpt55.558686.xyz/mcp
  • MCP SSE discovery: https://gpt55.558686.xyz/mcp/sse
  • MCP config: https://gpt55.558686.xyz/mcp/config
  • MCP server metadata: https://gpt55.558686.xyz/server.json
  • Directory channel registry: directory-channel-registry.json
  • Directory channel health check: examples/directory-channel-health/
  • Checkout drop-off summary: examples/checkout-dropoff-summary/
  • x402 discovery: https://gpt55.558686.xyz/.well-known/x402
  • OpenAPI: https://gpt55.558686.xyz/openapi.json
  • Pricing: https://gpt55.558686.xyz/pricing.json
  • Buyer guide: https://gpt55.558686.xyz/buyer-guide.json
  • Agent Payment Launchpad examples: examples/agent-payment-launchpad/
  • Agent Payment Launchpad Pages brief: https://go165.github.io/gpt55-x402-gateway/agent-payment-launchpad.html
  • x402 Translate First Purchase: https://gpt55.558686.xyz/x402/translate-first-purchase
  • x402 Translate First Purchase JSON: https://gpt55.558686.xyz/x402/translate-first-purchase.json
  • x402 Translate First Purchase examples: examples/translate-first-purchase/
  • x402 Translate First Purchase Pages brief: https://go165.github.io/gpt55-x402-gateway/translate-first-purchase.html
  • Payment Evidence Center: https://gpt55.558686.xyz/x402/payment-evidence-center
  • Payment Evidence Center JSON: https://gpt55.558686.xyz/x402/payment-evidence-center.json
  • Payment Evidence Center examples: examples/payment-evidence-center/
  • Payment Evidence Center Pages brief: https://go165.github.io/gpt55-x402-gateway/payment-evidence-center.html
  • x402 Receipt Verifier: https://gpt55.558686.xyz/x402/receipt-verifier
  • x402 Receipt Verifier JSON: https://gpt55.558686.xyz/x402/receipt-verifier.json
  • x402 Receipt Verifier examples: examples/receipt-verifier/
  • x402 Receipt Verifier Pages brief: https://go165.github.io/gpt55-x402-gateway/receipt-verifier.html
  • Agent Payment Control Plane: https://gpt55.558686.xyz/x402/agent-payment-control-plane
  • Agent Payment Control Plane JSON: https://gpt55.558686.xyz/x402/agent-payment-control-plane.json
  • Agent Payment Control Plane examples: examples/agent-payment-control-plane/
  • Agent Payment Safety Control Plane: https://gpt55.558686.xyz/x402/agent-payment-safety-control-plane
  • Agent Payment Safety Control Plane JSON: https://gpt55.558686.xyz/x402/agent-payment-safety-control-plane.json
  • Agent Payment Safety Control Plane examples: examples/agent-payment-safety-control-plane/
  • Agent Payment Safety Control Plane Pages brief: https://go165.github.io/gpt55-x402-gateway/agent-payment-safety-control-plane.html
  • Agent Payment Risk Gate: https://gpt55.558686.xyz/x402/agent-payment-risk-gate
  • Agent Payment Risk Gate JSON: https://gpt55.558686.xyz/x402/agent-payment-risk-gate.json
  • Agent Payment Risk Gate examples: examples/agent-payment-risk-gate/
  • Agent Payment Risk Gate Pages brief: https://go165.github.io/gpt55-x402-gateway/agent-payment-risk-gate.html
  • x402 Next Purchase Router examples: examples/x402-next-purchase-router/
  • x402 Next Purchase Router Pages brief: https://go165.github.io/gpt55-x402-gateway/x402-next-purchase-router.html
  • Agent Payment Policy Manifest: examples/agent-payment-policy-manifest/agent-payment-policy.json
  • Agent Payment Policy checker: examples/agent-payment-policy-manifest/
  • Agent Payment Policy Manifest Pages brief: https://go165.github.io/gpt55-x402-gateway/agent-payment-policy-manifest.html
  • Agent Payment Control Plane Pages brief: https://go165.github.io/gpt55-x402-gateway/agent-payment-control-plane.html
  • AI Crawler Monetization Kit: https://gpt55.558686.xyz/x402/ai-crawler-monetization-kit
  • AI Crawler Monetization Kit JSON: https://gpt55.558686.xyz/x402/ai-crawler-monetization-kit.json
  • AI Crawler Monetization Kit examples: examples/ai-crawler-monetization-kit/
  • AI Crawler Monetization Kit Pages brief: https://go165.github.io/gpt55-x402-gateway/ai-crawler-monetization-kit.html
  • First Purchase Router: https://gpt55.558686.xyz/x402/first-purchase-router
  • First Purchase Router JSON: https://gpt55.558686.xyz/x402/first-purchase-router.json
  • First Purchase Router examples: examples/first-purchase-router/
  • First Purchase Router Pages brief: https://go165.github.io/gpt55-x402-gateway/first-purchase-router.html
  • Buyer Conversion Suite: https://gpt55.558686.xyz/x402/buyer-conversion-suite
  • Buyer Conversion Suite JSON: https://gpt55.558686.xyz/x402/buyer-conversion-suite.json
  • Buyer Conversion Suite examples: examples/buyer-conversion-suite/
  • MCP First Purchase Kit: https://gpt55.558686.xyz/x402/mcp-first-purchase-kit
  • MCP First Purchase Kit JSON: https://gpt55.558686.xyz/x402/mcp-first-purchase-kit.json
  • MCP First Purchase examples: examples/mcp-first-purchase-kit/
  • MCP paid result contract fields: mcpRuntimeInstallPlan, buyerMcpExecutionContract, receiptGate
  • Agent Payment Readiness Lab: https://gpt55.558686.xyz/x402/agent-payment-readiness-lab
  • Agent Payment Readiness Lab JSON: https://gpt55.558686.xyz/x402/agent-payment-readiness-lab.json
  • Agent Payment Readiness examples: examples/agent-payment-readiness-lab/
  • Agent Payment Readiness Pages brief: https://go165.github.io/gpt55-x402-gateway/agent-payment-readiness.html
  • Wallet and Prepay First Purchase Center: https://gpt55.558686.xyz/x402/wallet-prepay-first-purchase
  • Wallet and Prepay First Purchase JSON: https://gpt55.558686.xyz/x402/wallet-prepay-first-purchase.json
  • Wallet and Prepay First Purchase examples: examples/wallet-prepay-first-purchase/
  • Wallet and Prepay First Purchase Pages brief: https://go165.github.io/gpt55-x402-gateway/wallet-prepay-first-purchase.html
  • Agent Checkout Kit: https://gpt55.558686.xyz/x402/agent-checkout-kit
  • Agent Checkout Kit JSON: https://gpt55.558686.xyz/x402/agent-checkout-kit.json
  • x402 First Payment Client: examples/x402-first-payment-client/
  • x402 First Payment Client Pages brief: https://go165.github.io/gpt55-x402-gateway/x402-first-payment-client.html
  • Agent Commerce Suite: https://gpt55.558686.xyz/x402/agent-commerce-suite
  • Agent Commerce Suite JSON: https://gpt55.558686.xyz/x402/agent-commerce-suite.json
  • Buyer payment policy pack: https://gpt55.558686.xyz/x402/buyer-payment-policy-pack
  • Buyer payment policy JSON: https://gpt55.558686.xyz/x402/buyer-payment-policy-pack.json
  • Buyer payment policy example: examples/buyer-payment-policy-pack/
  • Buyer payment paid result field: buyerAgentPaymentDecision with agentPolicyInputs and receiptEvidenceRequiredAfterPayment
  • Agent Commerce Suite examples: examples/agent-commerce-suite/
  • AgentCore/MCP buyer quickstart: examples/agentcore-mcp-buyer-quickstart/
  • Buyer safety guide: BUYER_SAFETY.md
  • Manual submission pack: SUBMISSION_PACK.md
  • Wallet signing risk kit: https://gpt55.558686.xyz/x402/wallet-signing-risk-kit
  • GitHub examples: examples/wallet-signing-risk-kit/
  • GitHub release: https://github.com/go165/gpt55-x402-gateway/releases/tag/v2026.06.18-wallet-safety-router
  • GitHub Pages docs: https://go165.github.io/gpt55-x402-gateway/
  • GitHub Pages IndexNow key: https://go165.github.io/gpt55-x402-gateway/2a90689e3e6f351286f9d32ed4fe8f1dea4c62904411609685959e7d995a4753.txt
  • Wallet signing safety example pack: https://gpt55.558686.xyz/x402/wallet-signing-risk-kit/example-pack.json
  • MCP wallet safety router: https://gpt55.558686.xyz/x402/wallet-signing-risk-kit/mcp-wallet-safety-router.ts
  • x402 prepay trust check: https://gpt55.558686.xyz/x402/prepay-trust-check
  • Approval risk auditor: https://gpt55.558686.xyz/x402/approval-risk-auditor
  • EIP-712 signing risk decoder: https://gpt55.558686.xyz/x402/eip712-signature-risk-decoder
  • EVM transaction risk decoder: https://gpt55.558686.xyz/x402/evm-transaction-risk-decoder
  • Merchant readiness: https://gpt55.558686.xyz/x402/merchant-readiness
  • Seller mini-check: https://gpt55.558686.xyz/v1/paid/x402-seller-mini-check
  • Seller mini-check example pack: examples/seller-mini-check/
  • Seller intelligence: https://gpt55.558686.xyz/v1/paid/x402-seller-intel
  • Seller action plan: https://gpt55.558686.xyz/v1/paid/x402-growth-plan
  • Pages merchant-readiness brief: https://go165.github.io/gpt55-x402-gateway/merchant-readiness.html

Market Positioning

  • Compact GPT-5.5 entry request: $0.0001, or 10,000 compact requests per $1.
  • Long GPT-5.5 request: $0.002134, up to 4096 output tokens.
  • True max-output GPT-5.5 request: $0.066667, up to 128000 output tokens.
  • Utility tools: from $0.0001.
  • Wallet and payment safety tools: paid deterministic EIP-712, EVM transaction, approval-risk, and x402 prepay trust checks for agents and wallets that need pre-signing or pre-payment review.
  • Agent payment control plane: a quote-to-settle control pack for agent wallets that need route selection, spend caps, payTo verification, wallet signing safety, MCP integration, and receipt evidence before a real x402 payment.
  • AI crawler monetization kit: a deterministic pay-per-crawl packaging tool for content sites, documentation sites, API publishers, and MCP services that want free discovery plus paid premium routes for AI crawlers and buyer agents.
  • Wallet signing safety router: public copy-paste JSON, Markdown, and TypeScript assets route buyers to the right paid safety check before x402 payment, EVM calldata signing, EIP-712 typed-data signing, or approval review.
  • x402/MCP/Bazaar integration kits: paid deterministic endpoints for buyers and sellers that need copy-paste-ready integration payloads.
  • Merchant readiness and seller intelligence: paid deterministic reports for x402 sellers that need buyer-ready API metadata, pricing, directory visibility, marketplace SEO, and paid MCP listing audits. Start with the $0.006 seller mini-check, then upgrade to the $0.019 growth plan or $0.029 seller-intelligence bundle.
  • Public x402 API listings commonly use per-call pricing around $0.001-$0.01; lead with the $0.0001 compact endpoint for trials, then route larger buyers to /v1/chat/completions/long and /v1/chat/completions/max.
  • Gross revenue per 1M output tokens is about $0.521 across the proportional chat tiers.
  • Public production quotes advertise exact and upto x402 on supported paid routes; /v1/x402-ping remains exact-only for lightweight proof checks. Fetch the endpoint without payment and use the returned payment-required header as the live price before paying.

Live quotes from https://gpt55.558686.xyz/pricing.json and unauthenticated HTTP 402 responses are authoritative. Directory pages can lag behind live x402 quote metadata.

Live Quote and Chain Verification

  • Always fetch the target endpoint without a payment header first. The live HTTP 402 payment-required header is the authoritative quote for amount, network, asset, and payTo.
  • Settlement address: 0x1f0130669ca6fd02e025a984cc038f139df19a2f on Base USDC.
  • Chain verification: check Base USDC Transfer events to that address on a Base explorer or RPC before treating a payment as settled.
  • Status endpoint: https://gpt55.558686.xyz/x402/status. If local log retention has gaps, prefer live 402 quotes and chain receipts over cached status summaries.

Tool Surface

The service exposes 100 MCP tools that route to direct x402-paid HTTP endpoints. Tool calls through the MCP facade return the direct endpoint, pricing, x402 discovery links, and example payload. Paid execution happens on the HTTP endpoint with x402 Base USDC or a private Bearer key; the MCP facade does not bypass payment.

Core endpoints include:

  • POST /v1/chat/completions
  • POST /v1/chat/completions/long
  • POST /v1/chat/completions/max
  • GET /v1/paid/chat-cdp
  • POST /v1/tools/summarize
  • POST /v1/tools/translate
  • POST /v1/tools/rewrite
  • POST /v1/tools/answer
  • POST /v1/tools/code-review
  • POST /v1/tools/extract-json
  • POST /v1/tools/x402-mcp-integration-kit
  • POST /v1/tools/x402-agentcore-integration-kit
  • GET /v1/tools/x402-prepay-trust-check
  • GET /v1/tools/x402-buyer-prepay-risk-score
  • GET /v1/paid/evm-transaction-risk-decoder
  • GET /v1/paid/eip712-signature-risk-decoder
  • POST /approval-risk-auditor/entrypoints/audit_approvals/invoke
  • GET /v1/paid/x402-seller-mini-check
  • GET /v1/paid/x402-seller-intel
  • GET /v1/paid/x402-growth-plan
  • deterministic utility endpoints for URL metadata, URL text, links, HTTP status, JSON validation, hashing, Base64, timestamps, regex, UUID, and text stats.

MCP first-purchase example: examples/mcp-first-purchase-kit/ shows how to quote the highest-signal MCP integration endpoint, check amount/network/payTo, and stop before payment.

First purchase router example: examples/first-purchase-router/ shows how to choose between MCP integration, buyer prepay risk, wallet signing risk, and seller mini-check routes, then verify live amount/network/payTo before any payment.

Wallet/prepay first-purchase example: examples/wallet-prepay-first-purchase/ shows how to quote buyer prepay risk, EIP-712 signing risk, EVM transaction risk, and approval-risk routes without paying, signing, registering, or using a private key.

x402 first-payment client: examples/x402-first-payment-client/ shows how a real buyer can move from quote-only checks to an opt-in wallet-owned x402 payment and capture receipt headers. It defaults to quote-only and refuses to pay unless PAY_REAL_X402=1 and EVM_PRIVATE_KEY are provided by the buyer.

Wallet signing safety payment-policy example: examples/wallet-signing-safety-pack/ shows how to fetch the live wallet safety pack quote, turn amount/network/payTo/asset into paymentPolicyInputs, and compute a local allow or deny decision before any wallet-owned payment.

Wallet signing guard examples: examples/wallet-signing-safety-pack/ includes npm run wallet-guard:mcp, npm run wallet-guard:flowise, and npm run wallet-guard:runtime for applying a paid agentEnforcementPayload in MCP, Flowise, and buyer-owned wallet runtimes without signing or paying again.

Payment evidence center example: examples/payment-evidence-center/ shows how a buyer-side agent can verify live quote amount, Base network, payTo, spend cap, receipt headers, and paid JSON evidence before deciding whether a buyer-owned wallet should pay.

x402 receipt verifier example: examples/receipt-verifier/ shows how a buyer-side agent can recompute receiptHash, actionRef, verification.digest, expected Base USDC network, payTo, amount cap, route, and transaction evidence after a buyer-owned payment. The sample verifier does not use a private key, sign, or send payment.

Agent payment safety control plane example: examples/agent-payment-safety-control-plane/ shows how a buyer-side agent can load the safety control plane, quote the wallet-signing-safety first-purchase route, verify amount/network/payTo/spend cap, and stop before payment.

Agent payment risk gate example: examples/agent-payment-risk-gate/ shows how a buyer-side agent can turn a live x402 quote into a local safe-to-pay decision by checking HTTP 402 status, amount, network, payTo, spend cap, and receipt evidence before any wallet-owned payment.

x402 next purchase router example: examples/x402-next-purchase-router/ shows how a buyer-side agent can read x402NextPurchase from a paid tool response, choose the wallet-safety or MCP next route, enforce amount/network/payTo policy, and stop before payment.

Agent payment control plane example: examples/agent-payment-control-plane/ shows how a buyer-side agent can load the broader control plane JSON, choose a route, verify live quote amount/network/payTo against policy, and stop before payment unless the buyer opts in from their own wallet environment.

Agent payment policy manifest: examples/agent-payment-policy-manifest/ gives buyer agents a local allowlist for first-purchase routes, a 0.02 USDC cap, expected Base USDC payTo, and a quote-only checker that refuses mismatched live 402 quotes.

AI crawler monetization example: examples/ai-crawler-monetization-kit/ shows how a content/API/MCP seller can quote the paid crawler monetization kit and inspect the expected result shape before paying.

Checkout drop-off summary: examples/checkout-dropoff-summary/ shows how an x402 seller can diagnose whether buyers stop at quote-only inspection, payment-header verification, or settlement. It parses local JSONL logs only and never signs, pays, or submits directory entries.

Recommended quote-only checkout for the bundled wallet and prepay decision:

npm run translate:first-quote
npm run wallet-policy:quote
npm run wallet-guard:mcp
npm run wallet-guard:flowise
npm run wallet-guard:runtime
npm run launchpad:quote
ROUTE_ID=wallet-signing-safety-pack MAX_USDC=0.02 node examples/x402-first-payment-client/first-payment-client.mjs

Translate first-purchase example: examples/translate-first-purchase/ shows how to fetch the live /v1/tools/translate HTTP 402 quote, verify amount/network/payTo/spend cap, and stop before payment. It is designed as the lowest-friction first paid route before a buyer upgrades into wallet safety, MCP integration, or the agent payment risk gate.

Seller mini-check example: examples/seller-mini-check/ shows how to fetch and decode the live HTTP 402 quote without paying, signing, registering, or using a private key.

Buyer Smoke Tests

MCP initialize:

curl -s https://gpt55.558686.xyz/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"smoke","version":"1.0.0"}}}'

x402 quote:

curl -i https://gpt55.558686.xyz/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"Say hi"}],"max_tokens":8}'

Expected unauthenticated response: HTTP 402 with a payment-required header containing Base USDC x402 payment requirements.

Glama / Docker Smoke

This repository includes a small no-secret Docker wrapper for directory checks such as Glama. It starts a local Streamable HTTP MCP endpoint at /mcp, proxies to the public remote MCP endpoint when available, and falls back to local introspection responses for initialize, tools/list, resources/list, and prompts/list.

The wrapper does not handle private keys, wallet signatures, KYC, JWTs, custody, or paid execution. Paid calls still happen through the public x402 HTTP endpoints advertised by the live gateway.

Run locally:

npm start

In another shell:

npm run smoke

Build and run with Docker:

docker build -t gpt55-x402-gateway .
docker run --rm -p 3000:3000 gpt55-x402-gateway

Then submit the repository to Glama using the Dockerfile in this repo. After Glama creates a public server page and score badge, update directory PRs with the generated badge URL.

Local Commands

cd D:\gpt55-token-gateway
npm start
npm run smoke
npm run stats
npm run funnel
npm run monitor

Start a temporary HTTPS tunnel:

D:\gpt55-token-gateway\start-tunnel.ps1

Use the https://...trycloudflare.com URL as the public base URL.

Poe API Bot Settings

  • base_url: tunnel URL, no trailing slash
  • api_type: chat_completions_api
  • model: gpt-5.5
  • api_key: value of PUBLIC_API_KEY in .env
  • pricing.prompt: 0.000005
  • pricing.completion: 0.00003
  • pricing.input_cache_reads: 0.0000005
  • context_pricing: optional; keep the same prices initially until real demand appears.

The gateway only forwards gpt-5.5 upstream, even if a caller passes another model name.

Create Poe Bot

  1. Open https://poe.com/api/keys in a browser where you are logged in.
  2. Create/copy a Poe API key.
  3. Put it in .env as POE_API_KEY=....
  4. Run:
cd D:\gpt55-token-gateway
npm run poe:create

x402 / USDC Settlement

Set these in .env to require on-chain payment for callers that do not use PUBLIC_API_KEY:

X402_ENABLED=true
X402_PAY_TO=0xYourBaseUsdcWallet
X402_NETWORK=eip155:8453
X402_PRICE=$0.0001
X402_LONG_PRICE=$0.002134
X402_MAX_PRICE=$0.066667
X402_TOOL_PRICE=$0.0001
X402_PROBE_PRICE=$0.0001
X402_ENABLE_UPTO=true
X402_UPTO_MARGIN=3.34
X402_UPTO_MIN_USD=0.0001
MAX_PAID_OUTPUT_TOKENS=192
MAX_LONG_PAID_OUTPUT_TOKENS=4096
MAX_TRUE_PAID_OUTPUT_TOKENS=128000

Restart the gateway after changing .env.

Calls with your PUBLIC_API_KEY still bypass the paywall, so Poe/private tests keep working.

Current x402 settings:

network: Base mainnet (eip155:8453)
asset: USDC
pay_to: 0x1f0130669ca6fd02e025a984cc038f139df19a2f
compact_chat_price: $0.0001 per compact chat completion request, max 192 output tokens
long_chat_price: $0.002134 per long chat completion request, max 4096 output tokens
max_chat_price: $0.066667 per max-output chat completion request, max 128000 output tokens
tool_price: $0.0001 per tool request
probe_price: $0.0001 per payment probe
facilitator: PayAI x402 (https://facilitator.payai.network), fallback xpay.sh; dedicated CDP/Bazaar route remains /v1/paid/chat-cdp
schemes: exact, upto on supported paid routes; /v1/x402-ping remains exact-only for lightweight proof checks
upto_status: enabled on the public production gateway; live HTTP 402 quotes remain authoritative

The lowest-cost x402 proof endpoint is available as both GET /v1/x402-ping and POST /v1/x402-ping. It does not call the upstream model. The CDP/Bazaar-compatible paid chat endpoint is GET /v1/paid/chat-cdp?q=...&max_tokens=...; it returns a live HTTP 402 x402 quote at $0.001 before payment and pays to the public Base USDC address above after settlement.

The public production gateway now advertises exact and upto x402 quotes on supported paid resources. Fetch the target endpoint without payment and use the HTTP 402 payment-required header as the authoritative amount immediately before paying. Historical marketplace listings or directory caches can lag behind live quotes.

Check the payment requirement:

cd D:\gpt55-token-gateway
npm run x402:check

Dry-run the cheapest payment flow without sending funds:

cd D:\gpt55-token-gateway
npm run pay:smoke

pay:smoke defaults to X402_PAY_SMOKE_TARGET=ping-get. Other targets are ping-post, summarize, and chat. It only sends a real payment when both X402_PAYER_PRIVATE_KEY is set and CONFIRM_X402_PAYMENT=true.

Monitor the full discovery and settlement funnel:

cd D:\gpt55-token-gateway
npm run monitor

The monitor writes logs\monitor.jsonl and checks:

  • public health and discovery endpoints
  • x402 402 quote shape and Bazaar extension
  • configured facilitator support and candidate facilitator availability
  • facilitator and CDP Bazaar discovery indexing
  • Base USDC receiver balance
  • local quote/settle/completion funnel

Submit to x402-list for manual review after setting an operator email:

cd D:\gpt55-token-gateway
$env:X402_LIST_CONTACT_EMAIL="[email protected]"
npm run x402list:submit

Submit the public discovery URLs to IndexNow-capable search engines:

cd D:\gpt55-token-gateway
npm run indexnow:submit

The gateway serves the IndexNow key at /<key>.txt. Set INDEXNOW_KEY only if you need a custom stable key; otherwise a deterministic public key is generated from the site URL and pay-to address.

Facilitator and directory discovery are not only website crawls. The pay-to address and configured facilitator must accept the payment requirements, and Bazaar-style discovery can lag until a successful settlement carries the resource metadata.

Logs

Usage logs are written to:

D:\gpt55-token-gateway\logs\usage.jsonl

Estimate revenue and cost from the local usage log:

cd D:\gpt55-token-gateway
npm run stats