# X402 Deploy

> Turn any API or MCP server into a paid service with x402

- **Type:** MCP server
- **Install:** `agentstack add mcp-nirholas-x402-deploy`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nirholas](https://agentstack.voostack.com/s/nirholas)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nirholas](https://github.com/nirholas)
- **Source:** https://github.com/nirholas/x402-deploy
- **Website:** https://x402s.vercel.app/

## Install

```sh
agentstack add mcp-nirholas-x402-deploy
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

---
## 🌎 Choose Your Site Template
- **[x402 Dashboard](https://x402s.vercel.app/)**
- x402 deploy was was originally [nirholas/universal-crypto-mcp](https://github.com/nirholas/universal-crypto-mcp)
- **[View Universal Crypto MCP 🛠️](https://mcp.giving/)**
- **[Deploy x402 Site deploy-x402.vercel.app]([deploy-x402.vercel.app](https://x402s.vercel.app/))**

---

## ✨ 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

```bash
# 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](docs/installation.md)
- [Configuration](docs/configuration.md)
- [Deployment Platforms](docs/deployment.md)
- [Pricing Strategies](docs/pricing.md)
- [Dashboard Guide](docs/dashboard.md)
- [API Reference](docs/api.md)

---

## 🎯 Supported Platforms

| Platform | Status | Deploy Time | Free Tier |
|----------|--------|-------------|-----------|
| Railway | ✅ | ~2 min | $5/month |
| Fly.io | ✅ | ~3 min | Yes |
| Vercel | ✅ | ~1 min | Yes |
| Docker | ✅ | ~30 sec | Self-hosted |

---

## 🏗️ Project Types

Automatically detects and configures:

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

---

## 💰 Pricing Models

```json
{
  "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:

```bash
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

```bash
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](CONTRIBUTING.md)

---

## 📄 License

MIT © [nirholas](https://github.com/nirholas)

---

## 🌟 Star History
(Original Repo, Universal Crypto MCP)
[](https://star-history.com/#nirholas/universal-crypto-mcp&Date)

---

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.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nirholas](https://github.com/nirholas)
- **Source:** [nirholas/x402-deploy](https://github.com/nirholas/x402-deploy)
- **License:** MIT
- **Homepage:** https://x402s.vercel.app/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-nirholas-x402-deploy
- Seller: https://agentstack.voostack.com/s/nirholas
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
