io.github.kwizzlesurp10-ctrl/x402-mcp

Official16 toolsLive

by kwizzlesurp10-ctrl · Python

Pay for HTTP APIs and charge for your own: x402 micropayments in USDC on Base.

MCP Server: io.github.kwizzlesurp10-ctrl/x402-mcp

The MCP server “io.github.kwizzlesurp10-ctrl/x402-mcp” provides functionality related to “x402 micropayments in USDC on Base.” Its description indicates support for paying for HTTP APIs and charging for your own services using that micropayment model.

🛠️ Key Features

x402 micropayments
USDC denomination
Deployment context: Base
Use case framing: paying for HTTP APIs and charging for your own

🚀 Use Cases

Paying for HTTP APIs
Monetizing your own services with x402 micropayments on Base

⚡ Developer Benefits

Clear alignment between HTTP API access and micropayment payments
Uses USDC on Base as the indicated payment approach

⚠️ Limitations

Only the high-level micropayment description is provided; no additional tools, endpoints, or MCP capabilities are specified in the available source data.

Captured live from the server via tools/list.

discover_services

Discover x402 Bazaar paid HTTP services via x402 HTTPFacilitatorClient.

Parameters4

query	any	optional
limit	integer	optional
max_price_usdc	any	optional
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    },
    "max_price_usdc": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Price Usdc"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "title": "discover_servicesArguments"
}

get_payment_requirements

Probe a URL for x402 payment requirements using x402HTTPClient SDK.

Parameters4

url	string	required
method	string	optional
headers	any	optional
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "title": "Url",
      "type": "string"
    },
    "method": {
      "default": "GET",
      "title": "Method",
      "type": "string"
    },
    "headers": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Headers"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "required": [
    "url"
  ],
  "title": "get_payment_requirementsArguments"
}

pay_and_fetch

Pay via x402HttpxClient and fetch a protected HTTP resource.

Parameters7

url	string	required
method	string	optional
headers	any	optional
body	any	optional
preferred_network	any	optional
max_price_usdc	any	optional
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "title": "Url",
      "type": "string"
    },
    "method": {
      "default": "GET",
      "title": "Method",
      "type": "string"
    },
    "headers": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Headers"
    },
    "body": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    },
    "preferred_network": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Preferred Network"
    },
    "max_price_usdc": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Price Usdc"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "required": [
    "url"
  ],
  "title": "pay_and_fetchArguments"
}

build_seller_requirements

Build seller-side x402 payment requirements via x402ResourceServer. Pass resource_url (plus optional discovery_* fields) to embed the Bazaar discovery extension so a settled payment catalogs the endpoint.

Parameters12

network	string	optional
pay_to	any	optional
price	string	optional
scheme	string	optional
description	string	optional
resource_url	any	optional
mime_type	any	optional
discoverable	any	optional
discovery_method	string	optional
discovery_input_example	any	optional
discovery_output_example	any	optional
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "network": {
      "default": "eip155:84532",
      "title": "Network",
      "type": "string"
    },
    "pay_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Pay To"
    },
    "price": {
      "default": "$0.01",
      "title": "Price",
      "type": "string"
    },
    "scheme": {
      "default": "exact",
      "title": "Scheme",
      "type": "string"
    },
    "description": {
      "default": "Paid MCP-backed API access",
      "title": "Description",
      "type": "string"
    },
    "resource_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Resource Url"
    },
    "mime_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "application/json",
      "title": "Mime Type"
    },
    "discoverable": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Discoverable"
    },
    "discovery_method": {
      "default": "GET",
      "title": "Discovery Method",
      "type": "string"
    },
    "discovery_input_example": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Discovery Input Example"
    },
    "discovery_output_example": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Discovery Output Example"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "title": "build_seller_requirementsArguments"
}

verify_payment_payload

Verify PAYMENT-SIGNATURE via x402ResourceServer + facilitator.

Parameters3

payment_signature	string	required
payment_required	string	required
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment_signature": {
      "title": "Payment Signature",
      "type": "string"
    },
    "payment_required": {
      "title": "Payment Required",
      "type": "string"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "required": [
    "payment_signature",
    "payment_required"
  ],
  "title": "verify_payment_payloadArguments"
}

get_supported_networks

List networks, facilitators, and v2 headers via x402 SDK.

Parameters1

agent_id

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "title": "get_supported_networksArguments"
}

get_pro_upgrade_requirements

Build x402 payment requirements to purchase Pro tier (revenue collection).

Parameters1

agent_id

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "title": "get_pro_upgrade_requirementsArguments"
}

activate_pro_tier

Verify pro-tier x402 payment and unlock Pro quota limits.

Parameters3

payment_signature	string	required
payment_required	string	required
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment_signature": {
      "title": "Payment Signature",
      "type": "string"
    },
    "payment_required": {
      "title": "Payment Required",
      "type": "string"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "required": [
    "payment_signature",
    "payment_required"
  ],
  "title": "activate_pro_tierArguments"
}

get_tool_credits_requirements

Build x402 payment requirements to purchase per-use MCP tool credits.

Parameters2

credits	any	optional
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "credits": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Credits"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "title": "get_tool_credits_requirementsArguments"
}

purchase_tool_credits

Verify x402 payment and add per-use tool credits (per-call revenue path).

Parameters4

payment_signature	string	required
payment_required	string	required
credits	any	optional
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment_signature": {
      "title": "Payment Signature",
      "type": "string"
    },
    "payment_required": {
      "title": "Payment Required",
      "type": "string"
    },
    "credits": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Credits"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "required": [
    "payment_signature",
    "payment_required"
  ],
  "title": "purchase_tool_creditsArguments"
}

create_stripe_checkout

Create Stripe Checkout Session for pro tier or tool credits (fiat rail).

Parameters3

purpose	string	optional
credits	any	optional
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "purpose": {
      "default": "pro_tier_upgrade",
      "title": "Purpose",
      "type": "string"
    },
    "credits": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Credits"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "title": "create_stripe_checkoutArguments"
}

run_swarm_research

Run the swarm Agency: compose a research product and list it for resale. Spends nothing by default — the report is synthesized from free inputs, so unsold inventory costs nothing. Pass allow_paid_inputs=True to buy upstream x402 services first (buy → compose → list), which books a cost basis before knowing whether the composite will sell.

Parameters4

topic	string	required
max_price_usdc	any	optional
agent_id	any	optional
allow_paid_inputs	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "title": "Topic",
      "type": "string"
    },
    "max_price_usdc": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Price Usdc"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    },
    "allow_paid_inputs": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Allow Paid Inputs"
    }
  },
  "required": [
    "topic"
  ],
  "title": "run_swarm_researchArguments"
}

settle_composite_sale

Verify + settle a buyer's x402 payment for a listed composite product and record the realized revenue (sell side).

Parameters4

product_id	string	required
payment_signature	string	required
payment_required	string	required
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "product_id": {
      "title": "Product Id",
      "type": "string"
    },
    "payment_signature": {
      "title": "Payment Signature",
      "type": "string"
    },
    "payment_required": {
      "title": "Payment Required",
      "type": "string"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "required": [
    "product_id",
    "payment_signature",
    "payment_required"
  ],
  "title": "settle_composite_saleArguments"
}

swarm_revenue_report

Portfolio revenue intelligence for the swarm: spend, revenue, LTV:CAC, margins, per-source profit scores.

Parameters1

agent_id

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "title": "swarm_revenue_reportArguments"
}

get_base_pulse

Live Base Network Pulse: synthesized settlement-conditions intelligence (base fee, EIP-1559 projection, utilization trend, USD settlement cost, and a settle-now/hold verdict) computed from real Base RPC data + ETH spot price.

Parameters2

depth	any	optional
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "depth": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Depth"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "title": "get_base_pulseArguments"
}

get_os_metrics

Host OS telemetry: CPU, memory, swap, disk, network, and process signals with an ok/warn/critical health verdict, sampled live from the machine running the server. Optionally includes the top processes by memory.

Parameters2

include_processes	boolean	optional
agent_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "include_processes": {
      "default": false,
      "title": "Include Processes",
      "type": "boolean"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Agent Id"
    }
  },
  "title": "get_os_metricsArguments"
}

README.md10 KBView on GitHub

x402 Micropayments MCP

Production MCP server for the x402 HTTP micropayment protocol — live on Base mainnet, selling real data products to AI agents for USDC today. Agents discover paid services, probe 402 Payment Required responses, pay with stablecoins, and build/verify seller payment configs; the server runs both sides of that market.

Live on Base mainnet

Storefront: https://x402-mcp.onrender.com — x402 v2 challenges served, USDC verified + settled through the Coinbase CDP facilitator (eip155:8453).

Product	Price	What you get
`GET /mn/property-check?address=…`	$0.01 USDC	Minneapolis rental-compliance snapshot composed from 3 live City of Minneapolis open datasets — the first machine-payable housing-compliance data for agents
`GET /swarm/products/{id}/purchase`	$0.25 USDC	Base Network Pulse: live settlement-conditions intelligence (EIP-1559 math + real RPC + ETH spot), listed with the x402 Bazaar discovery extension

The public seller host holds no spend key — it only verifies and settles inbound payments (docs/SELLER-STOREFRONT.md). Roadmap: ROADMAP.md.

Features

16 MCP tools for buyer, seller, Stripe fiat, x402 commerce, swarm-agency, and ops-monitoring flows — canonical inventory in app/tools_registry.py (single source for README, /.well-known/mcp, and tests); guarded by tests/test_readme.py and tests/test_manifest.py
x402/Coinbase rail (primary): x402 v2 wire format end to end — challenge generation, verify + settle via the CDP facilitator on Base mainnet, Bazaar discoverability on listings
Stripe payment rail (fiat alternative): create_stripe_checkout + POST /stripe/checkout + POST /stripe/webhook for card/bank payments
Commerce overlay: 500 calls/month, 10/min rate limit, meta envelope on every response
FastMCP + FastAPI with /.well-known/mcp manifest
stdio (Cursor/Grok local) and HTTP/SSE (remote connector) transports
Redis-ready quota store (in-memory default)
Operator dashboard at /dashboard — live health, per-agent quota burn-down meters, tool matrix, and revenue paths (single-file, zero build step)
Hermetic test suite — a local mock facilitator/discovery backend spins up automatically; no internet required. Set X402_LIVE_TESTS=1 to run against x402.org

Quick Start (Mission Control)

bash

git clone <repo> && cd x402-mcp
python -m venv .venv && .venv\Scripts\pip install -r requirements.txt && cd dashboard && pnpm install && cd ..
cp .env.example .env
make up

Open http://localhost:5173 — setup wizard runs with doctor checks. Toggle Demo to preview every panel with zero wallet.

Docs: docs/SETUP.md · docs/USER-GUIDE.md · docs/UI-HANDOFF-v2.md

Local stdio (Cursor)

bash

python run_stdio.py

Add to Cursor MCP config (manifests/cursor-mcp.json).

HTTP server

bash

uvicorn app.main:app --host 0.0.0.0 --port 8402
curl http://localhost:8402/.well-known/mcp
curl http://localhost:8402/health
# then open http://localhost:8402/dashboard

Paid HTTP Resource: MN Property Check

First-party sellable endpoint (the seller side of this repo's own tooling):

code

GET /mn/property-check?address=1700%20Penn%20Ave%20N

x402-gated at $0.01 USDC (MN_PROPERTY_CHECK_PRICE). Unpaid requests get a 402 with x402 v2 PAYMENT-REQUIRED terms; paid requests are verified and settled via the facilitator, then served with a PAYMENT-RESPONSE receipt.

One call returns a composite Minneapolis rental-compliance snapshot from live City of Minneapolis Open Data: active rental license (status, tier, licensed units, expiration, ward/neighborhood), regulatory violation case history (APN-joined), and condemned/boarded status. Owner phone/email in the source data are intentionally never served. Public records, as-is; not legal advice.

MCP Tools

Tool	Description
`discover_services`	Query x402 Bazaar for paid HTTP APIs
`get_payment_requirements`	Probe URL for `PAYMENT-REQUIRED` on 402
`pay_and_fetch`	Auto-pay and fetch protected resource
`build_seller_requirements`	Build seller payment requirements
`verify_payment_payload`	Verify payment via facilitator
`get_supported_networks`	Networks, facilitators, v2 headers
`get_pro_upgrade_requirements`	Build x402 payment requirements for Pro tier upgrade
`activate_pro_tier`	Verify x402 payment and unlock Pro tier quota
`get_tool_credits_requirements`	Build x402 payment requirements for per-use tool credits
`purchase_tool_credits`	Verify x402 payment and add per-use tool credits
`create_stripe_checkout`	Create Stripe Checkout Session for pro tier or credits
`run_swarm_research`	Swarm Agency: buy cheap upstream x402 services, compose a research report, list it for resale
`settle_composite_sale`	Verify + settle a buyer's payment for a listed composite and record revenue
`swarm_revenue_report`	Portfolio revenue intelligence: spend, revenue, LTV:CAC, margins, per-source profit scores
`get_base_pulse`	Live Base Network Pulse: synthesized settlement-conditions intelligence (base fee, utilization, USD cost, verdict) from real RPC data
`get_os_metrics`	Host OS telemetry: CPU, memory, swap, disk, network, and process signals with an ok/warn/critical health verdict

Environment

Variable	Required	Description
`X402_PAY_TO_ADDRESS`	For selling	Recipient wallet — all x402 sales settle here
`CDP_API_KEY_ID` / `CDP_API_KEY_SECRET`	For Base mainnet	Coinbase CDP facilitator creds (verify + settle on `eip155:8453`)
`SWARM_SELL_NETWORK`	For mainnet listings	Set `eip155:8453` to list products on Base mainnet (default: Base Sepolia)
`EVM_PRIVATE_KEY`	For `pay_and_fetch`	Buyer wallet private key — never set this on a public seller host
`STRIPE_SECRET_KEY`	For Stripe checkout	Fiat payment rail
`STRIPE_WEBHOOK_SECRET`	For `/stripe/webhook`	Webhook signature verification
`X402_FACILITATOR_URL`	No	Default: `https://x402.org/facilitator` (testnet; CDP handles mainnet)
`UPGRADE_URL`	No	Commerce tier upgrade link

Commerce Meta Envelope

Every tool response includes:

json

{
  "data": { "...": "..." },
  "meta": {
    "tier": "free",
    "calls_this_month": 1,
    "quota_remaining": 499,
    "quota_warning": false,
    "rate_limit_remaining": 9,
    "upgrade_url": "https://forge.example.com/upgrade",
    "agent_id": "..."
  }
}

Agent Ops / Swarm Agency

Cost-effective multi-agent operating group (scout, warden, treasurer, archivist, sovereign, merchant) with budget policy and ledger. See docs/agent-ops.md. Dashboard handoff: docs/UI-HANDOFF.md.

The Swarm Agency (app/swarm/) implements the hybrid resale loop end-to-end: scout discovers cheap upstream x402 services → warden enforces ledger/policy.json spend caps → treasurer pay_and_fetches and records cost basis to ledger/spend.jsonl → archivist composes a research report priced at cost × SWARM_MARKUP → sovereign (profit optimizer) reprices the composite to hit a target LTV:CAC (SWARM_TARGET_LTV_CAC, default 3.0), enforces a margin floor, and scores which upstream sources are actually profitable → merchant lists it via build_seller_requirements; settle_composite_sale records realized revenue. Portfolio economics (spend, revenue, LTV:CAC, per-source profit) surface via swarm_revenue_report / GET /swarm/revenue. Every phase streams to the dashboard's Swarm Activity panel over SSE. Run via the run_swarm_research MCP tool (needs EVM_PRIVATE_KEY + X402_PAY_TO_ADDRESS).

Multi-chain (EVM + Solana). The resource server registers ExactEvmServerScheme for eip155:* and ExactSvmServerScheme for solana:* (via the x402[svm] extra; solana>=0.36,<0.40). Seller requirements build on Base and Solana mainnet (solana:EtWTRAB…), and the buyer client registers an EVM and/or Solana signer from EVM_PRIVATE_KEY / SVM_PRIVATE_KEY — no marketing-vs-code gap.

Selling network / facilitators. The merchant lists on SWARM_SELL_NETWORK (default eip155:84532). The free x402.org facilitator only settles exact on Base Sepolia; to sell/settle on Base mainnet set SWARM_SELL_NETWORK=eip155:8453 and provide Coinbase CDP credentials (CDP_API_KEY_ID + CDP_API_KEY_SECRET) — the seller then routes verify/settle through the CDP facilitator with a per-request Ed25519 JWT (app/cdp_auth.py).

Base Network Pulse

Base Network Pulse (app/pulse.py + app/swarm/publisher.py) is a synthesis publisher: it turns free, high-quality Base RPC data (latest block, EIP-1559 base fee, block gas utilization) plus a live ETH spot price into a priced, x402-payable intelligence report. It projects the next-block base fee from the EIP-1559 formula, converts settlement gas into a live USD cost, and renders a settle-now / hold verdict on current Base settlement conditions. All inputs are real data — no mocks: real Base RPC calls, real Coinbase ETH price, real base-fee math.

Endpoints:

GET /pulse — live preview of the current synthesized pulse (base fee, utilization, USD settlement cost, verdict).
POST /pulse/publish — mints an x402-payable listing for the report (402-gated purchase endpoint).
get_base_pulse MCP tool — the same intelligence surfaced to agents.

This is the synthesis economic model: cost basis is ~$0 because the underlying Base data is free to read; the margin is the analysis itself. The priced report is sold to external buyers through the 402-gated purchase endpoint — pure synthesized value on top of free public data.

Testing

bash

pytest -v

See docs/SETUP.md for expected vs unexpected errors (wallet tools fail clearly until .env is configured).

Docker

bash

docker build -f deployment/Dockerfile -t x402-mcp .
docker run -p 8402:8402 x402-mcp

Drive Project Folder

Target: /Forge/MCP_Projects/x402-micropayments/

code

code/          → this repository
tests/         → pytest suite
docs/          → architecture.md
screenshots/   → verification images
manifests/     → cursor-mcp.json, /.well-known/mcp
deployment/    → Dockerfile

License

Apache-2.0 compatible with x402 Foundation ecosystem.

Install

Tools (16)

discover_servicesget_payment_requirementspay_and_fetchbuild_seller_requirementsverify_payment_payloadget_supported_networksget_pro_upgrade_requirementsactivate_pro_tier

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://x402-mcp.onrender.com/mcp/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://x402-mcp.onrender.com/mcp/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.