Skip to content
Back to search
100
MCP live MCP 2025-11-25 http

x402-mcp

kwizzlesurp10/x402-mcp

Pay 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.

Watch this dependency Share evidence report
Uptime
80.0%
5 direct probes · 30d
Response
1896ms
last probe
Tools
21
callable
Resources
6
readable
Prompts
3
available
Score: 100/100
Handshake verified by our own probe.
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
21 tools, 6 resources, 3 prompts returned.
pass 3 or more catalogue items 10/10
30 items in total; 3 or more earns these points.
pass Describes itself 10/10
184 characters; more than 30 earns these points.

Tools · 21

x402.agent_card

Return the A2A Protocol v1.0 Agent ID Card and MCP server card. Optional target_id filters to a skill id, name, or tag.

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.

x402.build_seller

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

x402.verify

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

x402.policy_check

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…

x402.networks

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.

commerce.pro_requirements

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

commerce.activate_pro

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…

commerce.credits_requirements

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.

commerce.purchase_credits

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…

swarm.research

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.

swarm.settle

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.

swarm.revenue

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…

pulse.base

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.

ops.metrics

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.

city.list

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.…

city.sample

Free fixed-address preview of paid property-check JSON (verdict, summary, schema). Use before city.check to validate parsing without spending $0.01 USDC.

city.check

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…

a2a.resolve_card

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

x402.instructions

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

x402://instructions
x402.catalog

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

x402://catalog
x402.agent-card

Full A2A Protocol v1.0 Agent ID Card and capability descriptor.

x402://agent-card
x402.server-card

Remote MCP Server Card for Smithery, Glama, and client indexing.

x402://server-card
x402.tools-manifest

Canonical MCP well-known manifest with tool specs, quotas, and endpoints.

x402://tools-manifest
x402.pricing-table

Machine-readable pricing for micropayments, subscriptions, and credits.

x402://pricing-table

Prompts · 3

x402.buy_paid_api

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

x402.sell_api

Walk an agent through building seller PAYMENT-REQUIRED terms and listing an endpoint in Bazaar.

city.compliance_path

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"
    }
  }
}