About x402 MCP Starter
x402 MCP Starter is a self-hosted Cloudflare Workers starter for adding USDC usage billing to an MCP server, aimed at developers deploying their own service. It includes configuration validation, a fixed-price sample tool, and payment-retry records; its public endpoint is for Base Sepolia testing only.
Key features
- 01Adds USDC billing to MCP tools
- 02Validates network, price, and recipient settings
- 03Demonstrates a fixed-price payment flow
- 04Records payment proofs and tool results
- 05Uses D1 for retry handling
Use cases
- 01Deploy paid MCP tools on Cloudflare Workers
- 02Check Base USDC payment settings before deployment
- 03Test a client payment round trip on Base Sepolia
- 04Retry the same payment and return its saved result
MCP support
It provides an MCP service over Streamable HTTP with a free configuration validator and a fixed-price paid sample tool. Unpaid calls return payment requirements for an x402-capable client to sign and retry.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://x402-mcp-starter.kadopi.workers.dev/mcpclaude mcp add --transport http kadopi-x402-mcp-starter https://x402-mcp-starter.kadopi.workers.dev/mcp{"mcpServers":{"kadopi-x402-mcp-starter":{"type":"http","url":"https://x402-mcp-starter.kadopi.workers.dev/mcp"}}}Open in Cursor{"servers":{"kadopi-x402-mcp-starter":{"type":"http","url":"https://x402-mcp-starter.kadopi.workers.dev/mcp"}}}Open in VS Code{"mcpServers":{"kadopi-x402-mcp-starter":{"type":"http","url":"https://x402-mcp-starter.kadopi.workers.dev/mcp"}}}{"mcpServers":{"kadopi-x402-mcp-starter":{"serverUrl":"https://x402-mcp-starter.kadopi.workers.dev/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
2| Parameter | Type | Required | Description |
|---|---|---|---|
| asset | string | Yes | |
| payTo | string | Yes | |
| amount | string | Yes | |
| network | enum | Yes | eip155:84532 | eip155:8453 |
| priceUsd | number | Yes | |
| facilitatorUrl | string | Yes |
Details
The maintainer has not added details yet. Check the README in the repository.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.