MCP Server
x402-mcp
io.github.kwizzlesurp10-ctrl/x402-mcp
What this MCP does
Discovers, probes, pays for, verifies, and serves x402-protected HTTP APIs using USDC, with tools for API commerce, agent cards, host metrics, and paid US property compliance checks.
Capabilities
Tools
20
tools
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'resolve_external_agent_cardArguments', 'required': ['target'], 'properties': {'target': {'type': 'string', 'title': 'Target', 'description': "Host domain or full URL of the agent (e.g. 'agent.example.com' or 'https://agent.example.com/.well-known/agent-card.json')"}, 'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional calling agent identifier for quota tracking.'}}}
Output schema
{'type': 'object', 'title': 'resolve_external_agent_cardOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
city.check
Paid US city property check
Run 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. Price: $0.01 per call (x402, USDC on Base/Solana/Arbitrum).
Open world
Input schema
{'type': 'object', 'title': 'check_us_city_propertyArguments', 'required': ['city_code', 'address'], 'properties': {'address': {'type': 'string', 'title': 'Address', 'description': "Street address to check. Example: '1700 Penn Ave N' or '1 Centre St'."}, 'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting.'}, 'city_code': {'type': 'string', 'title': 'City Code', 'description': "City code from city.list. Example: 'mn'."}, 'max_price_usdc': {'type': 'number', 'title': 'Max Price Usdc', 'default': None, 'description': 'Optional USDC spend ceiling. Example: 0.05.'}, 'preferred_network': {'type': 'string', 'title': 'Preferred Network', 'default': None, 'description': "Preferred CAIP-2 network. Example: 'eip155:8453'."}}}
Output schema
{'type': 'object', 'title': 'check_us_city_propertyOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'list_us_citiesArguments', 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting.'}}}
Output schema
{'type': 'object', 'title': 'list_us_citiesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_us_city_property_sampleArguments', 'required': ['city_code'], 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting.'}, 'city_code': {'type': 'string', 'title': 'City Code', 'description': "City code from city.list. Examples: 'mn', 'sea', 'nyc', 'chi'."}}}
Output schema
{'type': 'object', 'title': 'get_us_city_property_sampleOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
commerce.activate_pro
Activate Pro tier
Verify a Pro-tier x402 payment and unlock Pro quota limits for the agent. Call after commerce.pro_requirements and a completed USDC payment.
Open world
Input schema
{'type': 'object', 'title': 'activate_pro_tierArguments', 'required': ['payment_signature', 'payment_required'], 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Agent identity to grant Pro quota. Must match the requirements call.'}, 'payment_required': {'type': 'string', 'title': 'Payment Required', 'description': 'PAYMENT-REQUIRED JSON returned by commerce.pro_requirements.'}, 'payment_signature': {'type': 'string', 'title': 'Payment Signature', 'description': 'PAYMENT-SIGNATURE from the Pro-tier USDC payment.'}}}
Output schema
{'type': 'object', 'title': 'activate_pro_tierOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_tool_credits_requirementsArguments', 'properties': {'credits': {'type': 'integer', 'title': 'Credits', 'default': None, 'description': 'Credit pack size to buy. Example: 100. Omit to use the server default pack.'}, 'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity the credits will attach to.'}}}
Output schema
{'type': 'object', 'title': 'get_tool_credits_requirementsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_pro_upgrade_requirementsArguments', 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity the Pro grant will attach to.'}}}
Output schema
{'type': 'object', 'title': 'get_pro_upgrade_requirementsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
commerce.purchase_credits
Purchase tool credits
Verify an x402 payment and add per-use tool credits to the agent. Call after commerce.credits_requirements and a completed USDC payment.
Open world
Input schema
{'type': 'object', 'title': 'purchase_tool_creditsArguments', 'required': ['payment_signature', 'payment_required'], 'properties': {'credits': {'type': 'integer', 'title': 'Credits', 'default': None, 'description': 'Credit pack size that was purchased. Must match the requirements call.'}, 'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Agent identity to credit.'}, 'payment_required': {'type': 'string', 'title': 'Payment Required', 'description': 'PAYMENT-REQUIRED JSON returned by commerce.credits_requirements.'}, 'payment_signature': {'type': 'string', 'title': 'Payment Signature', 'description': 'PAYMENT-SIGNATURE from the credits USDC payment.'}}}
Output schema
{'type': 'object', 'title': 'purchase_tool_creditsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'get_os_metricsArguments', 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting.'}, 'include_processes': {'type': 'boolean', 'title': 'Include Processes', 'default': False, 'description': 'If true, include top processes by memory. Default false.'}}}
Output schema
{'type': 'object', 'title': 'get_os_metricsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_base_pulseArguments', 'properties': {'depth': {'type': 'integer', 'title': 'Depth', 'default': None, 'description': 'Blocks to sample. Example: 12. Omit to use the server default.'}, 'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting.'}}}
Output schema
{'type': 'object', 'title': 'get_base_pulseOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Open world
Input schema
{'type': 'object', 'title': 'run_swarm_researchArguments', 'required': ['topic'], 'properties': {'topic': {'type': 'string', 'title': 'Topic', 'description': "Research topic to compose. Example: 'Base mainnet gas window'."}, 'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Seller agent identity that will own the listing.'}, 'max_price_usdc': {'type': 'number', 'title': 'Max Price Usdc', 'default': None, 'description': 'Optional USDC ceiling for any paid upstream inputs.'}, 'allow_paid_inputs': {'type': 'boolean', 'title': 'Allow Paid Inputs', 'default': None, 'description': 'If true, buy upstream x402 services before composing. Default false (free inputs only, unsold inventory costs nothing).'}}}
Output schema
{'type': 'object', 'title': 'run_swarm_researchOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'swarm_revenue_reportArguments', 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting.'}}}
Output schema
{'type': 'object', 'title': 'swarm_revenue_reportOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Open world
Input schema
{'type': 'object', 'title': 'settle_composite_saleArguments', 'required': ['product_id', 'payment_signature', 'payment_required'], 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Seller agent identity recording the sale.'}, 'product_id': {'type': 'string', 'title': 'Product Id', 'description': 'Listed composite product id. Example: the hex id from swarm.research.'}, 'payment_required': {'type': 'string', 'title': 'Payment Required', 'description': 'PAYMENT-REQUIRED terms for this product.'}, 'payment_signature': {'type': 'string', 'title': 'Payment Signature', 'description': 'PAYMENT-SIGNATURE from the buyer.'}}}
Output schema
{'type': 'object', 'title': 'settle_composite_saleOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'get_agent_cardArguments', 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional calling agent identifier for quota tracking.'}, 'target_id': {'type': 'string', 'title': 'Target Id', 'default': None, 'description': 'Optional skill ID, tool name, or tag to inspect. Omit for the full server agent card.'}}}
Output schema
{'type': 'object', 'title': 'get_agent_cardOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'build_seller_requirementsArguments', 'properties': {'price': {'type': 'string', 'title': 'Price', 'default': '$0.01', 'description': "List price string. Default '$0.01'. Example: '$0.05'."}, 'pay_to': {'type': 'string', 'title': 'Pay To', 'default': None, 'description': "0x recipient for USDC. Example: '0x67ff…'. Omit to use X402_PAY_TO_ADDRESS."}, 'scheme': {'type': 'string', 'title': 'Scheme', 'default': 'exact', 'description': "x402 payment scheme. Default 'exact'."}, 'network': {'type': 'string', 'title': 'Network', 'default': 'eip155:84532', 'description': 'CAIP-2 settlement network. Default eip155:84532 (Base Sepolia). Mainnet: eip155:8453.'}, 'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting.'}, 'mime_type': {'type': 'string', 'title': 'Mime Type', 'default': 'application/json', 'description': 'Resource MIME type. Default application/json.'}, 'description': {'type': 'string', 'title': 'Description', 'default': 'Paid MCP-backed API access', 'description': 'Human-readable description embedded in PAYMENT-REQUIRED.'}, 'discoverable': {'type': 'boolean', 'title': 'Discoverable', 'default': None, 'description': 'If true, embed the Bazaar discovery extension. Omit to use server default.'}, 'resource_url': {'type': 'string', 'title': 'Resource Url', 'default': None, 'description': 'Public URL of the paid resource. When set with discovery_* fields, Bazaar catalogs the endpoint after a settled payment.'}, 'discovery_method': {'type': 'string', 'title': 'Discovery Method', 'default': 'GET', 'description': 'HTTP method advertised to Bazaar. Default GET.'}, 'discovery_input_example': {'type': 'object', 'title': 'Discovery Input Example', 'default': None, 'description': 'Optional example input object for Bazaar. Omit if none.', 'additionalProperties': True}, 'discovery_output_example': {'type': 'object', 'title': 'Discovery Output Example', 'default': None, 'description': 'Optional example output object for Bazaar. Omit if none.', 'additionalProperties': True}}}
Output schema
{'type': 'object', 'title': 'build_seller_requirementsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'discover_servicesArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'description': 'Maximum number of catalog entries to return. Default 20. Range 1–100.'}, 'query': {'type': 'string', 'title': 'Query', 'default': None, 'description': "Optional Bazaar search substring. Example: 'weather' or 'image'. Omit to list recent paid HTTP services."}, 'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': "Optional agent identity for quota accounting. Example: 'agent-42'. Omit to use the anonymous free-tier id."}, 'max_price_usdc': {'type': 'number', 'title': 'Max Price Usdc', 'default': None, 'description': 'Optional USDC price ceiling. Example: 0.05. Omit to include any listed price.'}}}
Output schema
{'type': 'object', 'title': 'discover_servicesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'get_supported_networksArguments', 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting.'}}}
Output schema
{'type': 'object', 'title': 'get_supported_networksOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Open world
Input schema
{'type': 'object', 'title': 'pay_and_fetchArguments', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'description': 'Absolute paid HTTP URL to fetch after settling USDC.'}, 'body': {'type': 'string', 'title': 'Body', 'default': None, 'description': 'Optional raw request body for POST/PUT. Omit for GET.'}, 'method': {'type': 'string', 'title': 'Method', 'default': 'GET', 'description': 'HTTP method for the paid request. Default GET.'}, 'headers': {'type': 'object', 'title': 'Headers', 'default': None, 'description': 'Optional extra request headers as a string map. Omit if none.', 'additionalProperties': {'type': 'string'}}, 'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting.'}, 'max_price_usdc': {'type': 'number', 'title': 'Max Price Usdc', 'default': None, 'description': 'Optional spend ceiling in USDC. Example: 0.10. Calls above this are blocked.'}, 'preferred_network': {'type': 'string', 'title': 'Preferred Network', 'default': None, 'description': "Preferred CAIP-2 network. Example: 'eip155:8453' (Base mainnet). Omit to use the server default. Call x402.networks to list options."}}}
Output schema
{'type': 'object', 'title': 'pay_and_fetchOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_payment_requirementsArguments', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'description': "Absolute HTTP URL to probe. Example: 'https://x402-mcp.onrender.com/us/mn/property-check?address=1700%20Penn%20Ave%20N'."}, 'method': {'type': 'string', 'title': 'Method', 'default': 'GET', 'description': "HTTP method for the probe. Default GET. Example: 'GET' or 'POST'."}, 'headers': {'type': 'object', 'title': 'Headers', 'default': None, 'description': 'Optional extra request headers as a string map. Example: {"Accept": "application/json"}. Omit if none.', 'additionalProperties': {'type': 'string'}}, 'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting. Omit for the anonymous free-tier id.'}}}
Output schema
{'type': 'object', 'title': 'get_payment_requirementsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Open world
Input schema
{'type': 'object', 'title': 'verify_payment_payloadArguments', 'required': ['payment_signature', 'payment_required'], 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id', 'default': None, 'description': 'Optional agent identity for quota accounting.'}, 'payment_required': {'type': 'string', 'title': 'Payment Required', 'description': 'PAYMENT-REQUIRED JSON/header the signature is meant to satisfy.'}, 'payment_signature': {'type': 'string', 'title': 'Payment Signature', 'description': 'PAYMENT-SIGNATURE header value from the buyer.'}}}
Output schema
{'type': 'object', 'title': 'verify_payment_payloadOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
History
Recent tool changes
Added
a2a.resolve_card
Oct. 1, 2026, 2:45 a.m.
Removed
mailrail.status
Sept. 21, 2026, 2:51 a.m.
Removed
mailrail.send
Sept. 21, 2026, 2:51 a.m.
Removed
mailrail.inbound
Sept. 21, 2026, 2:51 a.m.
Removed
get_agent_card
Sept. 21, 2026, 2:51 a.m.
Added
mailrail.inbound
Sept. 17, 2026, 12:42 p.m.
Added
mailrail.status
Sept. 17, 2026, 12:42 p.m.
Added
mailrail.send
Sept. 17, 2026, 12:42 p.m.
Added
city.check
Sept. 17, 2026, 12:42 p.m.
Added
city.sample
Sept. 17, 2026, 12:42 p.m.
Added
city.list
Sept. 17, 2026, 12:42 p.m.
Added
ops.metrics
Sept. 17, 2026, 12:42 p.m.
Added
pulse.base
Sept. 17, 2026, 12:42 p.m.
Added
swarm.revenue
Sept. 17, 2026, 12:42 p.m.
Added
swarm.settle
Sept. 17, 2026, 12:42 p.m.
Added
swarm.research
Sept. 17, 2026, 12:42 p.m.
Added
commerce.purchase_credits
Sept. 17, 2026, 12:42 p.m.
Added
commerce.credits_requirements
Sept. 17, 2026, 12:42 p.m.
Added
commerce.activate_pro
Sept. 17, 2026, 12:42 p.m.
Added
commerce.pro_requirements
Sept. 17, 2026, 12:42 p.m.
Added
x402.networks
Sept. 17, 2026, 12:42 p.m.
Added
x402.verify
Sept. 17, 2026, 12:42 p.m.
Added
x402.build_seller
Sept. 17, 2026, 12:42 p.m.
Added
x402.pay_and_fetch
Sept. 17, 2026, 12:42 p.m.
Added
x402.probe
Sept. 17, 2026, 12:42 p.m.
Added
x402.discover
Sept. 17, 2026, 12:42 p.m.
Added
get_agent_card
Sept. 17, 2026, 12:42 p.m.
Added
x402.agent_card
Sept. 17, 2026, 12:42 p.m.
Discover
Similar MCP servers
SAP MCP Server
ai.oobeprotocol.sap.mcp/sap-mcp
Provides an MCP gateway connecting SAP-related tools with Solana, DeFi, decentralized identity, and x402 payments.
Nexus Agent Network · AlpineLead OI
io.github.maxschnee74-source/alpinelead
Provides an agent marketplace and orchestration network with lead research, agent-to-agent messaging, task purchasing, and guarde…
tollbooth-authority
io.github.lonniev/tollbooth-authority
Operates a certified purchase-order and credit authority for MCP tool operators, including pricing, credit certification, balance…
tollbooth-authority-newengland
io.github.lonniev/tollbooth-authority-newengland
Provides regional authority services for MCP operator adoption, credit certification, pricing, balances, credentials, and hierarc…
tollbooth-authority-northamerica
io.github.lonniev/tollbooth-authority-northamerica
Provides North American regional authority services for MCP operator adoption, credit certification, pricing, balances, credentia…
Wisely x402 Agent-Payment Infrastructure
com.wiselyenterprisesllc/x402-agent-payment-infrastructure
Provides agent payment workflows for x402 endpoints, wallet handoffs, receipts, creator catalogs, local commerce bridges, endpoin…
skill-market
com.lvlltd/skill-market
Catalogs agent skills and supports discovery, evaluation, payment settlement, access checks and installation of purchased skill p…
Focxle: AI governance for B2B deals between agents
com.focxle/afos
Provides agent spending controls, delegated budgets, signed authority checks, negotiations, escrow contracts, workforce hiring, a…