MCP Billing Gateway

MCP 计费网关

为任何 MCP 服务添加 Stripe 订阅、按调用计费和 x402 加密货币支付，无需编写计费代码。

MCP Billing Gateway 是一个托管式计费代理，位于 AI Agent 与你的 MCP 服务之间。它会自动处理支付验证、用量跟踪和套餐限制。你只需注册服务、设置定价方案，并将调用方指向代理 URL。无需编写计费代码。

在线服务：https://mcp-billing-gateway-production.up.railway.app

教程：10 分钟让任何 MCP 服务实现营收 — 逐步演示，附带可运行代码

安装

pip install mcp-billing-gateway

也可以使用 uvx：

uvx mcp-billing-gateway

Claude Desktop 配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "mcp-billing-gateway": {
      "command": "uvx",
      "args": ["mcp-billing-gateway"]
    }
  }
}

Cursor 配置

添加到项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "mcp-billing-gateway": {
      "command": "uvx",
      "args": ["mcp-billing-gateway"]
    }
  }
}

添加配置后，重启编辑器以激活 MCP 服务。

工具

工具	说明
get_billing_info	返回服务功能、支持的支付方式、特性和集成文档

本地 MCP 服务提供服务发现功能。完整的计费功能由托管网关提供——注册为运营方，并通过该网关代理你的 MCP 服务。

工作原理

AI Agent → MCP Billing Gateway → Your MCP Server
            (billing enforced here)

1. 注册为运营方并获取 API 密钥
2. 注册你的 MCP 服务 URL 和定价方案
3. 将调用方指向你的代理标识：https://mcp-billing-gateway-production.up.railway.app/proxy/{your-slug}/mcp
4. 调用方通过 Stripe API 密钥或 x402 USDC 付款——计费过程透明处理

功能

• 按调用计费 — 按工具调用向调用方收费（法币或加密货币）
• 订阅 — 带调用次数限制的 Stripe 月度／年度方案
• 分级定价 — 免费套餐 + 按用量计费的付费套餐
• x402 小额支付 — 接受来自 AI Agent 的 Base 网络 USDC，无需 API 密钥
• 运营方仪表板 — 实时跟踪收入、用量和调用方
• MCP 传输 — 在 /mcp/ 端点提供完整的 Streamable HTTP MCP 传输

快速开始

1. 注册为运营方

curl -X POST https://mcp-billing-gateway-production.up.railway.app/api/v1/operator/register \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "name": "Your Name"}'

响应：

{
  "operator_id": "op_abc123",
  "api_key": "bg_live_xxxxxxxxxxxx",
  "message": "Operator registered successfully"
}

2. 注册你的 MCP 服务

curl -X POST https://mcp-billing-gateway-production.up.railway.app/api/v1/servers \
  -H "Authorization: Bearer bg_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My MCP Server",
    "upstream_url": "https://your-mcp-server.com/mcp",
    "proxy_slug": "my-server"
  }'

3. 创建定价方案

curl -X POST https://mcp-billing-gateway-production.up.railway.app/api/v1/servers/{server_id}/plans \
  -H "Authorization: Bearer bg_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pay as you go",
    "billing_model": "per_call",
    "price_per_call_usd_micro": 10000,
    "free_calls_per_month": 100
  }'

4. 将调用方连接到你的代理服务

{
  "mcpServers": {
    "my-server": {
      "url": "https://mcp-billing-gateway-production.up.railway.app/proxy/my-server/mcp",
      "headers": {
        "Authorization": "Bearer CALLER_API_KEY"
      }
    }
  }
}

支付方式

方式	适用对象	说明
Stripe 订阅	人类开发者	通过 Stripe Checkout 购买月度或年度方案
Stripe 按调用计费	人类开发者	每次工具调用消耗额度
x402 小额支付	AI Agent	使用 Base 网络 USDC，无需 API 密钥

示例

查看网关功能

# Using the MCP client
result = await session.call_tool("get_billing_info")
print(result)
# {
#   "service": "MCP Billing Gateway",
#   "version": "0.1.0",
#   "payment_methods": ["stripe_subscription", "stripe_metered", "x402_crypto"],
#   "features": ["Per-call usage tracking", "Tiered pricing", ...],
#   "live_service": "https://mcp-billing-gateway-production.up.railway.app"
# }

注册现有 MCP 服务并实现营收

# 1. Register
API_KEY=$(curl -s -X POST .../api/v1/operator/register \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "name": "Dev"}' | jq -r .api_key)

# 2. Add your server
SERVER_ID=$(curl -s -X POST .../api/v1/servers \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-tool", "upstream_url": "https://my-tool.com/mcp", "proxy_slug": "my-tool"}' \
  | jq -r .server_id)

# 3. Set pricing: $0.01 per call, 100 free calls/month
curl -X POST .../api/v1/servers/$SERVER_ID/plans \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Starter", "billing_model": "per_call", "price_per_call_usd_micro": 10000, "free_calls_per_month": 100}'

# Callers now connect via: .../proxy/my-tool/mcp

运营方仪表板

通过以下地址访问仪表板：

https://mcp-billing-gateway-production.up.railway.app/dashboard

实时跟踪收入、用量和活跃调用方，并配置你的服务。

API 参考

运营方端点

端点	方法	说明
/api/v1/operator/register	POST	创建运营方账户
/api/v1/operator/profile	GET	查看个人资料和 API 密钥
/api/v1/operator/stats	GET	查看收入和用量统计

服务管理

端点	方法	说明
/api/v1/servers	POST	注册 MCP 服务
/api/v1/servers	GET	列出你的服务
/api/v1/servers/{id}/plans	POST	创建定价方案

代理

端点	方法	描述
/proxy/{slug}/*	ANY	强制执行计费的代理调用
/mcp/	ANY	可流式传输的 HTTP MCP 传输

架构

┌─────────────┐     ┌──────────────────────┐     ┌──────────────────┐
│  AI Agent /  │────▶│  MCP Billing Gateway │────▶│  Your MCP Server │
│  MCP Client  │◀────│  (hosted on Railway)  │◀────│  (upstream)      │
└─────────────┘     └──────────────────────┘     └──────────────────┘
                         │
                         ├── Payment verification (Stripe / x402)
                         ├── Usage tracking & rate limiting
                         ├── Tier enforcement
                         └── Operator dashboard

该网关是一个透明代理。调用方可以像往常一样与您的 MCP 服务交互——网关会拦截请求、验证付款、跟踪用量，并将请求转发到您的上游服务。

可自托管

该网关可通过上方托管 URL 使用。若要自行托管，请克隆服务仓库并通过 Docker 部署：

docker build -t mcp-billing-gateway .
docker run -p 3000:3000 mcp-billing-gateway

许可证

MIT