x402-mcp
kwizzlesurp10/x402-mcpPay for HTTP APIs and charge for your own with x402 USDC micropayments on Base. Discover Bazaar services, probe 402 terms, pay-and-fetch, and run US city open-data property compliance.
Score: 100/100
Handshake verified by our own probe.
Tools · 21
Return the A2A Protocol v1.0 Agent ID Card and MCP server card. Optional target_id filters to a skill id, name, or tag.
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.
Decode a caller-supplied merchant PAYMENT-REQUIRED header and evaluate each accepts[] option against an explicit buyer policy (networks, pay_to, assets, max atomic amount). Does not fetch merchant URL…
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. MCP-native: call without payment to receive x402 requirements in the tool result, then retry with _meta['x402/payment'] (@x402…
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. MCP-native: call without payment for x402 requirements, then retry with _meta['x402/payment']. Legacy: PAYMENT-SIGNATURE + PAYMENT-REQ…
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 composite economics: spend, composite sales, LTV:CAC, margins, per-source scores. total_revenue_usdc is swarm listings only; storefront.revenue_usdc is the full settled ledger. Call after sw…
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 cities with paid_url and free sample_url for property compliance. Start here — each paid lookup is $0.01 USDC and returns a normalized verdict plus source link, not raw portal JSON. Then city.…
Free fixed-address preview of paid property-check JSON (verdict, summary, schema). Use before city.check to validate parsing without spending $0.01 USDC.
Is this US address licensed / flagged / showing open violations? One city.check ($0.01 USDC, x402 on Base) returns verdict, summary, dates, and source_url. Unpaid → PaymentRequired; pay via _meta['x40…
Discover and inspect an external Agent-to-Agent (A2A) node by domain or URL. Fetches .well-known/agent-card.json, validates protocol compatibility, checks for a2a-x402 and AP2 payment extensions, and …
Resources · 6
Server routing guide: which dotted tool to call, in what order, for buyer/seller/city flows.
x402://instructions
JSON catalog of dotted tool names, descriptions, and required env vars.
x402://catalog
Full A2A Protocol v1.0 Agent ID Card and capability descriptor.
x402://agent-card
Remote MCP Server Card for Smithery, Glama, and client indexing.
x402://server-card
Canonical MCP well-known manifest with tool specs, quotas, and endpoints.
x402://tools-manifest
Machine-readable pricing for micropayments, subscriptions, and credits.
x402://pricing-table
Prompts · 3
Walk an agent through discovering, probing, then paying for an x402 HTTP resource.
Walk an agent through building seller PAYMENT-REQUIRED terms and listing an endpoint in Bazaar.
Golden path for US City Open-Data Compliance: list → sample → paid check.
How to use
Claude Desktop or claude.ai: add a custom connector (Customize → Connectors; on Team and Enterprise plans an owner adds it under Organization settings → Connectors) with this server URL: https://x402-mcp.onrender.com/mcp
Cursor or Cline: add to your MCP config:
{
"mcpServers": {
"x402-mcp": {
"url": "https://x402-mcp.onrender.com/mcp",
"transport": "http"
}
}
}