MewCP Stripe MCP

Crea un registro de cliente en Stripe que puede contener métodos de pago, suscripciones y facturas.

Entradas:

- `api_key` (string, required) — Stripe API key (starts with sk_)
- `email` (string, optional) — Customer's email address
- `name` (string, optional) — Customer's full name
- `description` (string, optional) — Internal description for the customer
- `metadata` (string, optional) — JSON string of metadata key-value pairs (e.g. '{"plan": "enterprise"}')

Salida:

{
  "success": true,
  "customer_id": "cus_xxx",
  "email": "user@example.com",
  "name": "Jane Doe",
  "description": "Enterprise customer",
  "created": 1716720000,
  "metadata": {}
}

Devuelve los detalles completos del cliente, incluidos saldo, estado de morosidad y metadatos.

Entradas:

- `api_key` (string, required) — Stripe API key
- `customer_id` (string, required) — Customer ID (e.g. cus_xxx)

Salida:

{
  "success": true,
  "customer_id": "cus_xxx",
  "email": "user@example.com",
  "name": "Jane Doe",
  "balance": 0,
  "delinquent": false,
  "created": 1716720000,
  "metadata": {}
}

Devuelve hasta 100 clientes por página con paginación basada en cursor.

Entradas:

- `api_key` (string, required) — Stripe API key
- `limit` (integer, optional) — Number of customers to return, 1–100 (default: 10)
- `starting_after` (string, optional) — Customer ID to paginate from

Salida:

{
  "success": true,
  "has_more": true,
  "count": 10,
  "customers": [{ "id": "cus_xxx", "email": "...", "name": "...", "created": 1716720000 }]
}

Utiliza el lenguaje de consulta de búsqueda de Stripe para encontrar clientes que coincidan con criterios específicos.

Entradas:

- `api_key` (string, required) — Stripe API key
- `query` (string, required) — Search query (e.g. 'email:"user@example.com"' or 'name:"Jane"')
- `limit` (integer, optional) — Number of results, 1–100 (default: 10)

Salida:

{
  "success": true,
  "has_more": false,
  "count": 1,
  "customers": [{ "id": "cus_xxx", "email": "user@example.com", "name": "Jane Doe" }]
}

Crea un cargo directo a un cliente. El monto está en la unidad monetaria más pequeña (centavos para USD).

Entradas:

- `api_key` (string, required) — Stripe API key
- `amount` (integer, required) — Amount in cents (e.g. 1000 = $10.00)
- `currency` (string, optional) — Currency code: usd, eur, gbp, etc. (default: usd)
- `customer_id` (string, optional) — Customer ID to charge
- `description` (string, optional) — Description of the charge
- `metadata` (string, optional) — JSON string of metadata

Salida:

{
  "success": true,
  "charge_id": "ch_xxx",
  "amount": 1000,
  "currency": "usd",
  "status": "succeeded",
  "paid": true
}

Crea una intención de pago y devuelve un client_secret para la confirmación en el frontend mediante Stripe.js.

Entradas:

- `api_key` (string, required) — Stripe API key
- `amount` (integer, required) — Amount in cents
- `currency` (string, optional) — Currency code (default: usd)
- `customer_id` (string, optional) — Customer ID
- `description` (string, optional) — Description
- `metadata` (string, optional) — JSON string of metadata
- `confirm` (boolean, optional) — Confirm immediately (default: false)

Salida:

{
  "success": true,
  "payment_intent_id": "pi_xxx",
  "client_secret": "pi_xxx_secret_xxx",
  "amount": 2000,
  "currency": "usd",
  "status": "requires_payment_method"
}

Crea un producto en tu catálogo de Stripe. Los productos requieren un precio antes de poder venderse.

Entradas:

- `api_key` (string, required) — Stripe API key
- `name` (string, required) — Product name
- `description` (string, optional) — Product description
- `metadata` (string, optional) — JSON string of metadata

Salida:

{
  "success": true,
  "product_id": "prod_xxx",
  "name": "Pro Plan",
  "description": "Access to all pro features",
  "active": true
}

Define el monto de facturación y el intervalo para un producto. Admite precios únicos y recurrentes (suscripciones).

Entradas:

- `api_key` (string, required) — Stripe API key
- `product_id` (string, required) — Product ID to attach the price to
- `unit_amount` (integer, required) — Amount in cents
- `currency` (string, optional) — Currency code (default: usd)
- `recurring_interval` (string, optional) — 'month' or 'year' for subscription pricing

Salida:

{
  "success": true,
  "price_id": "price_xxx",
  "product": "prod_xxx",
  "unit_amount": 999,
  "currency": "usd",
  "recurring": { "interval": "month" }
}

Crea una suscripción recurrente para un cliente utilizando un ID de precio. Admite períodos de prueba.

Entradas:

- `api_key` (string, required) — Stripe API key
- `customer_id` (string, required) — Customer ID
- `price_id` (string, required) — Price ID for the subscription plan
- `trial_period_days` (integer, optional) — Number of free trial days
- `metadata` (string, optional) — JSON string of metadata

Salida:

{
  "success": true,
  "subscription_id": "sub_xxx",
  "customer": "cus_xxx",
  "status": "active",
  "current_period_start": 1716720000,
  "current_period_end": 1719312000
}

Cancela una suscripción al final del período de facturación actual o de inmediato.

Entradas:

- `api_key` (string, required) — Stripe API key
- `subscription_id` (string, required) — Subscription ID to cancel
- `cancel_at_period_end` (boolean, optional) — true = cancel at period end, false = cancel immediately (default: true)

Salida:

{
  "success": true,
  "subscription_id": "sub_xxx",
  "status": "active",
  "cancel_at_period_end": true
}

Devuelve los saldos disponibles y pendientes en todas las monedas para la cuenta de Stripe.

Entradas:

- `api_key` (string, required) — Stripe API key

Salida:

{
  "success": true,
  "available": [{ "amount": 50000, "currency": "usd" }],
  "pending": [{ "amount": 12000, "currency": "usd" }],
  "livemode": true
}

1. Ve al Panel de Stripe
2. Haz clic en Developers en la navegación superior
3. Selecciona API keys en la barra lateral izquierda
4. Copia tu clave secreta (comienza con sk_live_ para producción o sk_test_ para pruebas)

Usa claves sk_test_ durante el desarrollo: funcionan con números de tarjeta de prueba y no cargan tarjetas reales.

• Causa: La clave API no se proporcionó en los encabezados de la solicitud o el formato es incorrecto
• Solución:
  1. Verifica que los encabezados Authorization: Bearer YOUR_API_KEY y X-Mewcp-Credential-Id: CREDENTIAL-ID estén presentes
  2. Comprueba que la clave API esté activa en tu cuenta de MewCP

• Causa: Las llamadas a la API han superado tus límites de solicitudes
• Solución:
  1. Revisa el uso de créditos en tu panel de Curious Layer
  2. Mejora a un plan de pago o agrega créditos para límites más altos
  3. Contacta con soporte para ajustes de créditos

• Causa: No hay ninguna credencial de Stripe vinculada a tu cuenta
• Solución:
  1. Ve a Credenciales en tu panel de MewCP
  2. Agrega tu clave API de Stripe (autenticación estática)
  3. Reintenta la solicitud con el encabezado X-Mewcp-Credential-Id correcto

• Causa: El JSON de la carga útil no es válido o faltan campos obligatorios
• Solución:
  1. Valida la sintaxis JSON antes de enviar
  2. Asegúrate de incluir todos los parámetros obligatorios de la herramienta
  3. Verifica que los tipos de parámetros coincidan con los valores esperados

• Causa: Nombre de servidor incorrecto en el endpoint de la API
• Solución:
  1. Verifica el formato del endpoint: {server-name}/mcp/{tool-name}
  2. Usa el nombre de servidor correcto de la documentación
  3. Revisa los servidores disponibles en tu cuenta de Curious Layer

• Causa: La API de Stripe devolvió un error
• Solución:
  1. Revisa el estado del servicio de Stripe en Página de estado de Stripe
  2. Verifica que tu clave API tenga los permisos necesarios (modo live vs. test)
  3. Revisa el mensaje de error para obtener detalles específicos: los errores de Stripe son descriptivos

• Documentación de la API de Stripe — Referencia oficial de la API
• Referencia de la API de Stripe — Referencia completa de endpoints
• Documentación de FastMCP — Especificación de FastMCP
• Credenciales de FastMCP — Paquete de credenciales de FastMCP para el manejo de credenciales