x402-deploy

1-click deployment for monetized APIs & MCP servers

Turn any API or MCP server into a paid service in 5 minutes. No code changes required.

🌎 Related Projects

• x402-deploy: this repository. The hosted dashboard and site demos are offline while hosting is being migrated, so no live URL is published here yet.
• Universal Crypto MCP: the project x402-deploy originally grew out of.

✨ Features

• 💰 Instant Monetization - Charge per API call with crypto (USDC on Base)
• 🥳 1-Click Deploy - Railway, Fly.io, Vercel, or Docker
• 📊 Live Dashboard - Real-time earnings and analytics
• 🔍 Auto-Discovery - Automatic listing on x402scan.com
• 🛡️ Zero Trust - Payment verification before API access
• 🎨 Beautiful CLI - Stunning terminal UI with live updates

🐎 Quick Start

# Install globally
npm install -g @nirholas/x402-deploy

# Navigate to your API/MCP server
cd my-awesome-api

# Initialize (detects project automatically)
x402-deploy init

# Deploy (creates wallet, deploys, registers)
x402-deploy deploy

# Watch earnings
x402-deploy dashboard

That's it! Your API is now live and earning money. 💸

📦 What Gets Deployed?

x402-deploy wraps your existing API with a payment gateway:

┌─────────────────────────────────────┐
│   Your API (unchanged)              │
│   ↓                                 │
│   x402 Gateway (automatic)          │
│   ↓                                 │
│   Payment Verification              │
│   ↓                                 │
│   Analytics & Rate Limiting         │
│   ↓                                 │
│   Deployed to Cloud                 │
└─────────────────────────────────────┘

💡 Use Cases

• MCP Servers - Monetize Claude Desktop tools
• AI APIs - Charge for GPT wrappers, embeddings
• Trading Bots - Sell API access to strategies
• Data APIs - Weather, crypto prices, analytics
• Web Services - Any REST/HTTP API

📚 Documentation

• Installation Guide
• Configuration
• Deployment Platforms
• Pricing Strategies
• Dashboard Guide
• API Reference

🎯 Supported Platforms

🏗️ Project Types

Automatically detects and configures:

• ✅ MCP Servers (@modelcontextprotocol/sdk)
• ✅ Express APIs
• ✅ Fastify
• ✅ FastAPI (Python)
• ✅ Next.js
• ✅ Generic Node.js/Python

💰 Pricing Models

{
  "pricing": {
    "model": "per-call",
    "default": { "price": "$0.01" },
    "routes": {
      "GET /api/*": "$0.0001",
      "POST /api/trade": "$0.10",
      "GET /api/free": "$0"
    }
  }
}

📊 Dashboard

Beautiful terminal dashboard with live updates:

x402-deploy dashboard

╔═══════════════════════════════════════════╗
║   Earnings Summary                        ║
╠═══════════════════════════════════════════╣
║  Today:     $12.45  (1,245 calls)         ║
║  This Week: $87.32  (8,732 calls)         ║
║  All Time:  $1,547  (154,718 calls)       ║
╚═══════════════════════════════════════════╝

🔧 CLI Commands

x402-deploy init              # Initialize project
x402-deploy deploy            # Deploy to cloud
x402-deploy deploy --dry-run  # Preview deployment
x402-deploy dashboard         # Live earnings dashboard
x402-deploy pricing           # Manage pricing
x402-deploy status            # Check deployment status
x402-deploy logs              # View deployment logs
x402-deploy withdraw          # Withdraw earnings
x402-deploy export --csv      # Export analytics

🤝 Contributing

We love contributions! See CONTRIBUTING.md

📄 License

All rights reserved. See LICENSE.

🌟 Star History

(Original Repo, Universal Crypto MCP)

As with most of my repos, I spend a lot of time building then find something interesting or have a need for something and i start on the next. I hope this at the very least is a good resource you can use to monetize your APIs and MCP Servers. What I truly hope to build is a community of developers, I love shipping alone but i wouldn't mind collaborating here and there. Please, always feel free to PR and throw an issue down. I am waiting.

Documentation

Full documentation site: https://nirholas.github.io/x402-deploy/

• Getting started covers install and first run.
• Examples has copy-paste snippets.

Support the project

If x402-deploy saves you time, star it on GitHub. Stars are how other developers and AI agents find the repositories worth trusting, and they cost you one click.

Know someone who would use it? Post on X · Share on Bluesky · Share on LinkedIn · Submit to Hacker News · Share on Reddit

Built for AI agents too

Coding agents and LLM tooling can read this repo directly: AGENTS.md, llms.txt, llms-full.txt. Point an agent at https://github.com/nirholas/x402-deploy and it has the context it needs.

More from the same author

• All repositories by nirholas: the full catalog, grouped by topic
• three.ws: the platform for 3D AI agents with Solana wallets, a skill marketplace and x402 payments
• Questions or ideas: open an issue or start a discussion

Contributors