MCP Billing Gateway

Proxy reverso que adiciona faturamento Stripe e pagamentos cripto x402 a qualquer servidor MCP

Documentação

MCP Billing Gateway

Adicione assinaturas Stripe, créditos por chamada e pagamentos cripto x402 a qualquer servidor MCP — sem escrever código de cobrança.

O MCP Billing Gateway é um proxy de cobrança hospedado que fica entre agentes de IA e seu servidor MCP. Ele lida com verificação de pagamento, rastreamento de uso e aplicação de níveis automaticamente. Você registra seu servidor, define um plano de preços e aponta os chamadores para a URL do proxy. Nenhum código de cobrança necessário.

Serviço ao vivo: https://mcp-billing-gateway-production.up.railway.app

Tutorial: Monetize qualquer servidor MCP em 10 minutos — demonstração passo a passo com código funcional

Instalação

pip install mcp-billing-gateway

Ou com uvx:

uvx mcp-billing-gateway

Configuração para Claude Desktop

Adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Configuração para Cursor

Adicione em .cursor/mcp.json no seu projeto:

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

Reinicie seu editor após adicionar a configuração para ativar o servidor MCP.

Ferramentas

Ferramenta	Descrição
`get_billing_info`	Retorna as capacidades do serviço, métodos de pagamento suportados, recursos e documentação de integração

O servidor MCP local fornece descoberta de serviços. Toda a funcionalidade de cobrança roda no gateway hospedado — registre-se como operador e faça proxy dos seus servidores MCP por meio dele.

Como funciona

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

Registre-se como operador e obtenha uma chave de API
Registre a URL do seu servidor MCP + plano de preços
Aponte os chamadores para o seu slug de proxy: https://mcp-billing-gateway-production.up.railway.app/proxy/{your-slug}/mcp
Os chamadores pagam via chave de API Stripe ou USDC x402 — a cobrança é tratada de forma transparente

Recursos

Cobrança por chamada — cobre dos chamadores por chamada de ferramenta (fiat ou cripto)
Assinaturas — planos Stripe mensais/anuais com limites de chamadas
Preços em níveis — nível gratuito + níveis pagos com base no uso
Micropagamentos x402 — aceite USDC na Base de agentes de IA sem chaves de API
Painel do operador — acompanhe receita, uso e chamadores em tempo real
Transporte MCP — transporte MCP HTTP Streamable completo no endpoint /mcp/

Início Rápido

1. Registre-se como operador

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

Resposta:

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

2. Registre seu servidor 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. Crie um plano de preços

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. Conecte chamadores ao seu servidor com proxy

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

Métodos de Pagamento

Método	Ideal para	Como
Assinatura Stripe	Desenvolvedores humanos	Plano mensal ou anual via Stripe Checkout
Stripe por chamada	Desenvolvedores humanos	Créditos consumidos por chamada de ferramenta
Micropagamentos x402	Agentes de IA	USDC na Base, sem necessidade de chaves de API

Exemplos

Verificar capacidades do gateway

# 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"
# }

Registrar e monetizar um servidor MCP existente

# 1. Register
API_KEY=$(curl -s -X POST .../api/v1/operator/register \
  -H "Content-Type: application/json" \
  -d '{"email": "dev@example.com", "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

Painel do Operador

Acesse seu painel em:

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

Acompanhe receita, uso, chamadores ativos e configure seus servidores em tempo real.

Referência da API

Endpoints do operador

Endpoint	Método	Descrição
`/api/v1/operator/register`	POST	Criar conta de operador
`/api/v1/operator/profile`	GET	Ver perfil e chaves de API
`/api/v1/operator/stats`	GET	Estatísticas de receita e uso

Gerenciamento de servidores

Endpoint	Método	Descrição
`/api/v1/servers`	POST	Registrar um servidor MCP
`/api/v1/servers`	GET	Listar seus servidores
`/api/v1/servers/{id}/plans`	POST	Criar plano de preços

Proxy

Endpoint	Método	Descrição
`/proxy/{slug}/*`	ANY	Chamadas com proxy e aplicação de cobrança
`/mcp/`	ANY	Transporte MCP HTTP Streamable

Arquitetura

┌─────────────┐     ┌──────────────────────┐     ┌──────────────────┐
│  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

O gateway é um proxy transparente. Os chamadores interagem com seu servidor MCP normalmente — o gateway intercepta as solicitações, verifica o pagamento, rastreia o uso e encaminha para o seu servidor upstream.

Auto-hospedado

O gateway está aberto para uso na URL hospedada acima. Para implantações auto-hospedadas, clone o repositório do servidor e implante via Docker:

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

Licença

MIT