x402 Micropayments MCP

io.github.kwizzlesurp10-ctrlPublished by GitHub account kwizzlesurp10-ctrlv1.30.0Updated Oct 24, 2026

Pay-per-call US city property compliance and Base tx checks, paid in USDC on Base via x402.

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinanceBusiness & Commerce

Overview

AI-generated overview

A remote MCP server for x402 micropayments: discover paid HTTP APIs, inspect prices, pay in USDC, and sell or settle paid resources.

What you can do
Discover and inspect x402 paid APIs and A2A agent cards, and probe a URL's payment terms without spending. Pay USDC for protected HTTP resources and verify buyer payment signatures. Build seller-side payment requirements and list your own endpoints in the Bazaar. Buy Pro quota or per-use tool credits, and run a research swarm that lists and settles composite products with revenue reporting. Check Base network fees, host telemetry, and paid US city property compliance lookups.
When to use it
Use it when an assistant needs to call x402-paywalled APIs, charge or settle payments for its own resources, or run paid US city property compliance checks. Useful for agents experimenting with agent-to-agent paid services and micropayment economics.
Requirements
A remote streamable HTTP endpoint; no local runtime or account is declared. Paying for resources requires EVM_PRIVATE_KEY on the host, and a funded wallet with USDC on supported networks such as Base, Solana or Arbitrum. Network access to the endpoint and the x402 facilitator.
Before you install
pay_and_fetch spends real USDC and needs EVM_PRIVATE_KEY, a wallet private key, on the host. Several tools spend money: city.check at $0.01 per call, Pro quota, tool credits, and swarm research with paid inputs. Seller tools build payment requirements and settle buyer payments, recording revenue. Host telemetry and external agent cards are fetched from third parties.

Installation

In SourceWeft

  1. Open x402 Micropayments MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.kwizzlesurp10-ctrl%2Fx402-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "x402-micropayments": {
      "type": "http",
      "url": "https://x402-mcp.onrender.com/mcp/mcp"
    }
  }
}

README

This repository has no README.

Tools

20

x402.agent_card

A2A Agent ID 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.

Parametersagent_idtarget_id

x402.discover

Discover x402 services

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.

Parameterslimitqueryagent_idmax_price_usdc

x402.probe

Probe x402 payment requirements

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.

Parametersurlrequiredmethodheadersagent_id

x402.pay_and_fetch

Pay and fetch x402 resource

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.

Parametersurlrequiredbodymethodheadersagent_idmax_price_usdcpreferred_network

x402.build_seller

Build seller payment requirements

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

Parameterspricepay_toschemenetworkagent_idmime_typedescriptiondiscoverableresource_urldiscovery_methoddiscovery_input_examplediscovery_output_example

x402.verify

Verify x402 payment signature

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

Parametersagent_idpayment_requiredrequiredpayment_signaturerequired

x402.networks

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

Parametersagent_id

commerce.pro_requirements

Build Pro-tier payment requirements

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

Parametersagent_id

commerce.activate_pro

Activate Pro tier

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/mcp client). Legacy: pass PAYMENT-SIGNATURE + PAYMENT-REQUIRED after commerce.pro_requirements.

Parametersagent_idpayment_requiredpayment_signature

commerce.credits_requirements

Build tool-credit payment 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.

Parameterscreditsagent_id

commerce.purchase_credits

Purchase tool 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-REQUIRED after commerce.credits_requirements.

Parameterscreditsagent_idpayment_requiredpayment_signature

swarm.research

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

Parameterstopicrequiredagent_idmax_price_usdcallow_paid_inputs

swarm.settle

Settle composite sale

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.

Parametersagent_idproduct_idrequiredpayment_requiredrequiredpayment_signaturerequired

swarm.revenue

Swarm revenue report

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 swarm.research or swarm.settle to inspect realized economics.

Parametersagent_id

pulse.base

Base network pulse

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.

Parametersdepthagent_id

ops.metrics

Host OS 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.

Parametersagent_idinclude_processes

city.list

List US compliance cities

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.

Parametersagent_id

city.sample

US city property sample

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.

Parametersagent_idcity_coderequired

city.check

Paid US city property check

Paid US city property compliance check (MCP seller x402). Unpaid calls return PaymentRequired with accepts; pay via _meta['x402/payment']. Prefer city.sample first. Price: $0.01 per call (x402, USDC on Base/Solana/Arbitrum).

Parametersaddressrequiredagent_idcity_coderequiredmax_price_usdcpreferred_network

a2a.resolve_card

Resolve external A2A Agent 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 extracts callable skills with pricing.

Parameterstargetrequiredagent_id

Version history

2
  1. v1.30.0LatestOct 17, 2026
  2. v0.1.0Sep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.