io.github.kwizzlesurp10-ctrl/x402-mcp

Discover paid HTTP APIs in the x402 Bazaar via the facilitator catalog. Call this first to find a resource URL, then x402.probe and x402.pay_and_fetch.

Probe a URL for HTTP 402 PAYMENT-REQUIRED terms using the x402 client SDK. Use before x402.pay_and_fetch to inspect price, network, and payTo without spending.

Pay USDC via x402 and fetch a protected HTTP resource in one call. Requires EVM_PRIVATE_KEY on this host; otherwise use x402.probe for a no-spend 402.

Build seller-side x402 payment requirements for your own HTTP resource. Pass resource_url plus discovery_* fields to catalog the endpoint in Bazaar.

Verify an x402 PAYMENT-SIGNATURE against PAYMENT-REQUIRED terms via the facilitator. Call after a buyer presents a signature and before releasing paid content.

List supported settlement networks, facilitators, and x402 v2 header names. Call when choosing a preferred_network for x402.pay_and_fetch or x402.build_seller.

Build x402 payment requirements to purchase the Pro quota tier. Next: pay those terms, then commerce.activate_pro with the signature.

Verify a Pro-tier x402 payment and unlock Pro quota limits for the agent. Call after commerce.pro_requirements and a completed USDC payment.

Build x402 payment requirements to buy a pack of per-use MCP tool credits. Next: pay those terms, then commerce.purchase_credits with the signature.

Verify an x402 payment and add per-use tool credits to the agent. Call after commerce.credits_requirements and a completed USDC payment.

Create a Stripe Checkout Session for Pro tier or tool credits (fiat rail). Use when the buyer pays by card instead of USDC; webhook fulfills the grant.

Run the swarm agency: compose a research product from free inputs and list it for resale. Pass allow_paid_inputs=true only when buying upstream x402 services is intended.

Verify and settle a buyer's x402 payment for a listed composite product and record revenue. Call with product_id plus PAYMENT-SIGNATURE after the buyer pays.

Get swarm portfolio revenue intelligence: spend, revenue, LTV:CAC, margins, per-source scores. Call after swarm.research or swarm.settle to inspect realized economics.

Get live Base Network Pulse: base fee, EIP-1559 projection, utilization, USD settlement cost, verdict. Call before settling on Base when you need a settle-now vs hold recommendation.

Get host OS telemetry: CPU, memory, swap, disk, network, and an ok/warn/critical health verdict. Call to diagnose this MCP host; set include_processes=true for top memory processes.

List US City Open-Data Compliance Network cities with paid_url, sample_url, and price. Call first, then city.sample, then city.check for the paid address lookup.

Get a free fixed-address property compliance sample for one US city code. Use before city.check to validate city_code and response shape without paying.

Run a paid US city property compliance check via x402 on the same HTTP resource buyers use. Prefer city.sample first. Settles USDC when EVM_PRIVATE_KEY is set; otherwise returns a 402 probe.

Server routing guide: which dotted tool to call, in what order, for buyer/seller/city flows.

JSON catalog of dotted tool names, descriptions, and required env vars.

Walk an agent through discovering, probing, then paying for an x402 HTTP resource.

Golden path for US City Open-Data Compliance: list → sample → paid check.