Best for
- Developers needing a remote MCP server on Cloudflare quickly
- Developers wanting to monetize MCP tools
- Projects requiring user authentication
M
MCP Boilerplate
Community
Archived
A remote Cloudflare MCP server boilerplate with user authentication and Stripe for paid tools.
GitHub source repository ↗
48FMRS · D
A comprehensive MCP server boilerplate particularly suited for deploying remote MCP servers on Cloudflare with paid features, but requires some familiarity with Cloudflare and Stripe.
MCP Boilerplate is an open-source project to create your own remote MCP server on Cloudflare with user login (Google or GitHub) and Stripe payments (subscription, metered, or one-time). It provides a simple step-by-step setup guide making it accessible to non-experts.
Tools
add
Free tool example: adds two numbers.
subscriptionAdd
Paid tool example: addition tool requiring a subscription.
meteredAdd
Paid tool example: addition tool billed by usage.
onetimeAdd
Paid tool example: addition tool with a one-time payment.
Setup
Clone the repository, npm install, create KV namespace OAUTH_KV, configure Google/GitHub OAuth, set up Stripe keys, fill in .dev.vars, run npx wrangler dev, then deploy.
Fit and risk
Not for
- Local MCP servers
- Developers preferring non-Cloudflare platforms
- Simple projects without auth or payments
Required permissions
- Cloudflare account access
- Google or GitHub OAuth credentials
- Stripe API keys
Risks and side effects
- API keys and encryption keys must be kept secure
- Incorrect Stripe configuration can cause payment issues
- Cloudflare deployment may incur costs
Troubleshooting
- Ensure the OAUTH_KV namespace name is correct
- Check that all secrets in .dev.vars are complete
- Verify Stripe price IDs are correct
- Confirm the Cloudflare Worker URL is properly configured
Use cases
Host a remote MCP server on Cloudflare
Add user authentication to MCP tools
Implement paid MCP tools via Stripe
Quickly prototype an MCP server
Supported clients
Claude DesktopFull support
CursorFull support
Cloudflare AI PlaygroundFull support
MCP InspectorFull support