Skip to main content
Glama
deenesjakoruzh
sapph1re

MCP Billing Gateway SDK

by sapph1re
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Pasarela de Facturación MCP

Glama MCP Server

Añade suscripciones de Stripe, créditos por llamada y pagos cripto x402 a cualquier servidor MCP, sin escribir código de facturación.

La Pasarela de Facturación MCP es un proxy de facturación alojado que se sitúa entre los agentes de IA y tu servidor MCP. Gestiona automáticamente la verificación de pagos, el seguimiento de uso y la aplicación de niveles. Registras tu servidor, estableces un plan de precios y diriges a los usuarios a la URL del proxy. No se requiere código de facturación.

Servicio en vivo: https://mcp-billing-gateway-production.up.railway.app

Instalación

pip install mcp-billing-gateway

O con uvx:

uvx mcp-billing-gateway

Configuración para Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Configuración para Cursor

Añade a .cursor/mcp.json en tu proyecto:

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

Reinicia tu editor después de añadir la configuración para activar el servidor MCP.

Related MCP server: Agent Bazaar

Herramientas

Herramienta

Descripción

get_billing_info

Devuelve las capacidades del servicio, métodos de pago soportados, características y documentación de integración

El servidor MCP local proporciona descubrimiento de servicios. La funcionalidad completa de facturación se ejecuta en la pasarela alojada: regístrate como operador y haz proxy de tus servidores MCP a través de ella.

Cómo funciona

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

  1. Regístrate como operador y obtén una clave API

  2. Registra la URL de tu servidor MCP + plan de precios

  3. Dirige a los usuarios a tu slug de proxy: https://mcp-billing-gateway-production.up.railway.app/proxy/{your-slug}/mcp

  4. Los usuarios pagan mediante clave API de Stripe o USDC x402: la facturación se gestiona de forma transparente

Características

  • Facturación por llamada — cobra a los usuarios por llamada a herramienta (fiat o cripto)

  • Suscripciones — planes mensuales/anuales de Stripe con límites de llamadas

  • Precios escalonados — nivel gratuito + niveles de pago basados en el uso

  • Micropagos x402 — acepta USDC en Base de agentes de IA sin necesidad de claves API

  • Panel de operador — realiza un seguimiento de ingresos, uso y usuarios en tiempo real

  • Transporte MCP — transporte MCP HTTP completo y transmitible en el endpoint /mcp/

Inicio rápido

1. Regístrate 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"}'

Respuesta:

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

2. Registra tu 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. Crea un plan de precios

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. Conecta a los usuarios a tu servidor 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 pago

Método

Ideal para

Cómo

Suscripción Stripe

Desarrolladores humanos

Plan mensual o anual vía Stripe Checkout

Stripe por llamada

Desarrolladores humanos

Créditos consumidos por llamada a herramienta

Micropagos x402

Agentes de IA

USDC en Base, no se necesitan claves API

Ejemplos

Comprobar capacidades de la pasarela

# 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 y monetizar un 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

Panel de operador

Accede a tu panel en:

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

Realiza un seguimiento de ingresos, uso, usuarios activos y configura tus servidores en tiempo real.

Referencia de API

Endpoints de operador

Endpoint

Método

Descripción

/api/v1/operator/register

POST

Crear cuenta de operador

/api/v1/operator/profile

GET

Ver perfil y claves API

/api/v1/operator/stats

GET

Estadísticas de ingresos y uso

Gestión de servidores

Endpoint

Método

Descripción

/api/v1/servers

POST

Registrar un servidor MCP

/api/v1/servers

GET

Listar tus servidores

/api/v1/servers/{id}/plans

POST

Crear plan de precios

Proxy

Endpoint

Método

Descripción

/proxy/{slug}/*

ANY

Llamadas proxy con aplicación de facturación

/mcp/

ANY

Transporte MCP HTTP transmitible

Arquitectura

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

La pasarela es un proxy transparente. Los usuarios interactúan con tu servidor MCP normalmente: la pasarela intercepta las solicitudes, verifica el pago, rastrea el uso y reenvía al servidor upstream.

Autoalojamiento

La pasarela está abierta para su uso en la URL alojada anteriormente. Para despliegues autoalojados, clona el repositorio del servidor y despliega mediante Docker:

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

Licencia

MIT

Install Server
A
license - permissive license
B
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • Prepcast MCP

    Bbadhub
    F
    license
    Not graded
    quality
    D
    maintenance
    A comprehensive framework for building and deploying commercial MCP servers with integrated billing, usage metering, and Stripe payment processing. It enables developers to monetize AI tools through a complete ecosystem including API key management, affiliate tracking, and automated deployment scripts.

  • Agent Bazaar

    TombStoneDash
    A
    license
    Not graded
    quality
    C
    maintenance
    Per-call billing and metering proxy for MCP tool servers. Providers set pricing via the open MCP Billing Spec (MIT), consumers pay through Stripe Connect with signed receipts and SLA monitoring.
    MIT

  • JWT Doctor

    Baneado98
    A
    license
    Not graded
    quality
    C
    maintenance
    Template for creating MCP servers with a server-side paywall gate, enabling free local usage and premium hosted tier with Stripe and x402 payment lanes.
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sapph1re/mcp-billing-gateway-sdk'

If you have feedback or need assistance with the MCP directory API, please join our Discord server