About x402-cloudflare-starter
x402-cloudflare-starter is a Cloudflare Workers checkout server for agent-facing USDC payments on Base, with Solana as an option. It suits operators who want to accept payments using their own wallets; paid endpoints return receipts rather than unlocking a product.
Key features
- 01USDC payments via x402
- 02Base settlement with optional Solana
- 03Worker API and demo endpoint
- 04SKU catalog and receipt ledger
- 05Paid handlers return receipts
Use cases
- 01Accept agent payments for listed SKUs
- 02Inspect receipts and available SKUs
- 03Deploy a checkout endpoint with own wallets
MCP support
It includes an MCP server at `mcp/server.ts`; the README does not describe its tools or exposed capabilities.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEx402 Cloudflare Starter
The simplest way to accept USDC payments on Base + Solana using x402. Bring your own wallets. No Coinbase account required.
This repo is the agent checkout rail for ANAMIZED first-dollar SKUs. Humans use Stripe Payment Links. Agents use x402. Same prices. Host owns fulfillment.
Base is the default settlement network (eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). Solana is an optional parallel.
Surfaces
| Surface | Entry |
|---|---|
| API (Worker) | src/index.ts |
| 60s demo | GET /demo |
| Receipt ledger | GET /v1/receipts |
| SKU catalog | src/catalog.ts + GET /v1/catalog |
| MCP Server | mcp/server.ts |
| Application pack | docs/APPLICATION_PACK.md |
Agent checkout (hybrid)
Free: GET / · GET /health · GET /demo · GET /v1/catalog · GET /v1/receipts
| SKU | x402 | Stripe (human) |
|---|---|---|
| Agentic OS Cycle $0.75 | GET /v1/cycle | Stripe |
| OpenGOS Search $0.40 | GET /v1/search | Stripe |
| OpenGOS Draft $2.50 | GET /v1/draft | Stripe |
| Trading Decision Cycle $4.00 | GET /v1/trading | Stripe |
Paid handlers return a receipt only. They do not unlock Desk Studio. Trading receipts are not live execution.
Documented receive addresses:
| Network | Address |
|---|---|
| Base / Ethereum | 0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438 |
| Solana | ETQwWf19axArsY493UfC6bxe2BmEzmzvCb58PPnC38A |
Quick Start
npm install
npx wrangler secret put BASE_ADDRESS
npx wrangler secret put SOLANA_ADDRESS
npx wrangler deploy
License
MIT
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.