x402-mcp

The complete autonomous agent economy toolkit.

CommunityDegradedNo sign-inGlobalFreeRead-only

What it can do

  • X402.Discover: 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.
  • X402.Probe: 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.
  • X402.Pay And Fetch: 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.

What data it sees

Do you need an account

No: the server works without sign-in

The complete autonomous agent economy toolkit. Equip your agents to seamlessly execute USDC micropayments over x402 on Base, run complex property compliance checks across US cities, optimize blockchain gas fees, and leverage Agent ID cards for cross-agent discovery and auditing. A robust, production-ready server that turns passive LLMs into active economic participants.

How to connect

How to connect x402-mcp to Claude

The server address to paste into Claude settings:

https://x402-mcp--kwizzlesurp10.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect x402-mcp to ChatGPT

The server address to paste into ChatGPT settings:

https://x402-mcp--kwizzlesurp10.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect x402-mcp to Cursor

The server address to paste into Cursor settings:

https://x402-mcp--kwizzlesurp10.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (19)

Raw names from tools/list. Only developers need these.

x402.discoverDiscover 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.
x402.probeProbe 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.
x402.pay_and_fetchPay 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.
x402.build_sellerBuild seller-side x402 payment requirements for your own HTTP resource. Pass resource_url plus discovery_* fields to catalog the endpoint in Bazaar.
x402.verifyVerify an x402 PAYMENT-SIGNATURE against PAYMENT-REQUIRED terms via the facilitator. Call after a buyer presents a signature and before releasing paid content.
x402.networksList supported settlement networks, facilitators, and x402 v2 header names. Call when choosing a preferred_network for x402.pay_and_fetch or x402.build_seller.
commerce.pro_requirementsBuild x402 payment requirements to purchase the Pro quota tier. Next: pay those terms, then commerce.activate_pro with the signature.
commerce.activate_proVerify a Pro-tier x402 payment and unlock Pro quota limits for the agent. Call after commerce.pro_requirements and a completed USDC payment.
commerce.credits_requirementsBuild x402 payment requirements to buy a pack of per-use MCP tool credits. Next: pay those terms, then commerce.purchase_credits with the signature.
commerce.purchase_creditsVerify an x402 payment and add per-use tool credits to the agent. Call after commerce.credits_requirements and a completed USDC payment.
commerce.stripe_checkoutCreate 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.
swarm.researchRun 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.
swarm.settleVerify 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.
swarm.revenueGet swarm portfolio revenue intelligence: spend, revenue, LTV:CAC, margins, per-source scores. Call after swarm.research or swarm.settle to inspect realized economics.
pulse.baseGet 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.
ops.metricsGet 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.
city.listList 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.
city.sampleGet 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.
city.checkRun 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.