---
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.

```bash
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](https://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.