X402 Cloudflare Starter

What x402-cloudflare-starter does

The x402-cloudflare-starter MCP server provides an agent-oriented checkout layer for fixed-price services hosted by a Cloudflare Worker. It uses x402 to accept USDC payments and is designed around bring-your-own-wallet operation, so the checkout flow does not require a Coinbase account.

Base is the primary settlement network, identified as eip155:8453, with the listed USDC contract address for that chain. Solana is available as an additional settlement option. The documented receiving addresses are configured separately for Base/Ethereum and Solana.

The repository includes free routes for the root response, health checks, a short demo, the SKU catalog, and receipt records. Paid routes cover an Agentic OS Cycle, OpenGOS Search, OpenGOS Draft, and Trading Decision Cycle. Each paid handler returns a receipt. The documentation states that receipts do not unlock Desk Studio and that trading receipts do not represent live execution.

How it works

The Worker API is implemented at src/index.ts, while the catalog is defined in src/catalog.ts. The repository also contains an MCP server at mcp/server.ts. The README identifies the MCP surface but does not provide a list of named MCP tools or describe a client-specific protocol configuration.

Agent checkout uses x402 for the paid HTTP routes. The listed prices are $0.75 for the Agentic OS Cycle, $0.40 for OpenGOS Search, $2.50 for OpenGOS Draft, and $4.00 for the Trading Decision Cycle. Human checkout is represented separately with Stripe Payment Links, while the agent path uses x402.

The free routes can be used to inspect the service before payment. GET /v1/catalog exposes the available SKU information, and GET /v1/receipts exposes the receipt ledger. The /demo route provides a 60-second demonstration surface.

Setup and configuration

Install the project dependencies with npm, then provide the receiving wallet addresses as Cloudflare Worker secrets:

npm install
npx wrangler secret put BASE_ADDRESS
npx wrangler secret put SOLANA_ADDRESS
npx wrangler deploy

BASE_ADDRESS holds the Base/Ethereum receiving address, and SOLANA_ADDRESS holds the Solana receiving address. The quick-start instructions include both secrets before deployment. The documented Base address is 0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438; the documented Solana address is ETQwWf19axArsY493UfC6bxe2BmEzmzvCb58PPnC38A.

Tools and capabilities

The x402-cloudflare-starter MCP server is associated with the Worker checkout API, but the supplied README does not enumerate individual MCP tool names. Supported documented surfaces include:

• Free health, demo, catalog, and receipt endpoints.
• Paid endpoints for four fixed-price service SKUs.
• USDC settlement on Base by default.
• Optional parallel settlement on Solana.
• Receipt-only responses from paid handlers.
• A catalog source in src/catalog.ts and a Worker entry point in src/index.ts.

Limitations and notes

The supplied material does not document MCP client compatibility, named MCP tool schemas, authentication beyond the x402 payment flow, or local development commands beyond installation and deployment. Confirm those details in the repository before integrating with a particular agent host.

This project is an agent checkout rail, not a general payment dashboard. The README distinguishes agent payments from human Stripe checkout, and the two paths use different entries. Paid responses are receipts only; they do not grant access to Desk Studio. A trading receipt also does not execute a trade.

The project is licensed under MIT. Base is the default network, so Solana should be treated as an optional deployment path rather than the primary settlement target.