README.md

metadata

title: create-mcpay
emoji: 🪙
colorFrom: purple
colorTo: pink
sdk: static
pinned: false
license: mit

create-mcpay

Cloudflare Worker template for pay-per-call agent gateways. Every call costs a few mcents (1 mcent = 1/1000¢); agents pay in crypto via x402.

npx create-mcpay my-api
cd my-api
wrangler kv:namespace create KEYS
wrangler secret put ADMIN_KEY
wrangler deploy

Repo: github.com/walter-grace/create-mcpay

What's in the box

• Bearer-token auth backed by Workers KV
• mcent pricing (1/1000¢) — sub-cent calls legible + storable as integers
• x402 signup — strangers pay USDC on Base via Coinbase CDP facilitator, no Stripe, no email
• Scoped keys (crawl, label, read, all) for tiered access
• XP + leaderboard + badges via a Durable Object (race-free)
• Refund policy with rate cap to block refund-farming
• Agent Readiness well-known routes (/llms.txt, /.well-known/mcp.json, /robots.txt with Content Signals)
• MCP server at /mcp — Claude Desktop / Cursor / Zed install in one config block

Why

Agents need:

1. A way to authenticate — bearer keys beat OAuth dashboards
2. A balance to draw down — mcents so $0.01 covers 100 calls
3. A self-serve onramp — x402 so strangers mint keys programmatically
4. Reputation primitives — XP, levels, badges so markets reward quality
5. Discoverability — Agent Readiness + MCP so agents find you

Stripe, OAuth, and dashboards add friction agents can't traverse. mcpay skips all of that.