prime-agent-stripe-mcp

Integración oficial de MCP de Stripe para Prime Agent.

Prime Agent se conecta al servidor MCP remoto oficial de Stripe en https://mcp.stripe.com. El agente puede entonces inspeccionar y gestionar recursos de Stripe a través de la misma superficie de API que otros clientes MCP.

[!NOTE] El servidor MCP de Stripe está en vista previa pública. Expone herramientas de lectura y de escritura. Mantén la conexión en modo de prueba mientras desarrollas.

┌─────────────────────────────────┐                      ┌─────────────────────────────────┐
│ │ from stripe import         │  │                      │ │ mcp.stripe.com              │ │
│ │   stripe                   │  │                      │ │ API · billing · reporting   │ │
│ │ await stripe.list_tools()  │──┼   OAuth 2.1 + PKCE   │ │ products · customers        │ │
│ │ await stripe.call_tool(    │  │                      │ │ subscriptions · events      │ │
│ auth.json: mcp:stripe           │                      │ │ documentation search        │ │
└─────────────────────────────────┘                      └─────────────────────────────────┘

Por qué esta integración

• Servidor alojado por Stripe — no hay ningún proxy autoalojado ni clave de API de Stripe en este repositorio.

• Nativo de Prime Agent — el módulo extiende McpIntegration y expone el inventario de herramientas en vivo desde el kernel de Python.

• OAuth 2.1 con PKCE — la aprobación del navegador se guarda únicamente en el auth.json privado de Prime Agent bajo mcp:stripe.

• Pensado para el modo de prueba — autoriza la cuenta de Stripe de Liminal y utiliza únicamente recursos del modo de prueba durante el desarrollo.

Related MCP server: stripe-mcp

Instalación

Requiere Prime Agent con su kernel de Python y Python 3.10 o superior.

1. Clona el repositorio y enlaza la skill en su sitio:

   git clone https://github.com/gbrlpzz/prime-agent-stripe-mcp.git ~/prime-agent-stripe-mcp
   rm -rf ~/.agents/skills/stripe
   ln -s ~/prime-agent-stripe-mcp ~/.agents/skills/stripe

2. Instala el paquete editable en el entorno del kernel de Prime Agent:

   uv pip install --python ~/.prime/agent/kernel-venv/bin/python -e ~/prime-agent-stripe-mcp

3. Añade el servidor remoto a la configuración de MCP de Prime Agent una única vez:

   {
     "mcpServers": {
       "stripe": {
         "type": "http",
         "url": "https://mcp.stripe.com",
         "oauth": true
       }
     }
   }

4. Recarga Prime Agent y autoriza la cuenta de Stripe:

   /reload
   /mcp login stripe

Aprueba la cuenta de Stripe de Limia, no una cuenta personal o de producción que deba permanecer fuera de este flujo de trabajo de desarrollo. Prime Agent guarda la credencial como mcp:stripe. Nunca se escribe en este repositorio.

Uso

from stripe import stripe, auth_status

print(auth_status())               # credential state, no token values
tools = await stripe.list_tools()  # live Stripe MCP inventory
# Inspect the live schema before calling a read or write tool.
result = await stripe.call_tool("<live-tool-name>", {"<live-argument>": "..."})

auth_status() devuelve un pequeño dict sin secretos:

{"enabled": True, "expires_fresh": True, "type": "oauth"}

Los nombres de las herramientas y sus parámetros pertenecen a Stripe y pueden cambiar durante la vista previa pública. Llama primero a list_tools() o usa los métodos enlazados automáticamente desde el inventario en vivo.

El servidor incluye herramientas para el descubrimiento de la API de Stripe, lecturas y escrituras de API, información de cuenta, recursos de facturación, documentación e informes. Las operaciones de escritura modifican datos de Stripe. Pide confirmación humana antes de crear, actualizar, cancelar, reembolsar o eliminar cualquier cosa.

Respaldo de renovación del token

Prime Agent renueva automáticamente el token almacenado. En los hosts donde esto no esté disponible, llama al respaldo a nivel de módulo:

from stripe import refresh

refresh()  # exchanges the stored refresh token; rewrites auth.json with mode 600

Flujo de trabajo de desarrollo de Liminal

1. Añade tu usuario personal como miembro del equipo de la cuenta de Stripe de Liminal.

2. Autoriza esta integración con ese usuario.

3. Confirma que el panel de Stripe está en modo de prueba.

4. Crea únicamente productos, precios, clientes y suscripciones de prueba.

5. Configura la función stripe-webhook de Supabase con el secreto de firma del webhook de prueba resultante, por separado. La credencial MCP no sustituye a STRIPE_SECRET_KEY ni a STRIPE_WEBHOOK_SECRET del lado del servidor.

Solución de problemas

Desarrollo

python3 tests/test_skill.py                             # standalone suite, no Prime Agent needed
~/.prime/agent/kernel-venv/bin/python -m pytest tests/  # inside Prime Agent's kernel

CI ejecuta la suite de pruebas independiente en cada push a main.

Seguridad

• No se guardan credenciales en este repositorio ni en su historial de Git.

• Los tokens OAuth se guardan únicamente en el auth.json privado de Prime Agent.

• El módulo se comunica únicamente con https://mcp.stripe.com y con el servidor de autorización OAuth de Stripe.

• Mantén todas las mutaciones de desarrollo en el modo de prueba de Stripe.

• No incluyas nunca valores de secretos de Stripe ni material de clave privada en código fuente, pruebas, documentación o historial de Git.

Licencia

MIT — consulta LICENSE. Stripe es una marca comercial de Stripe, Inc.; esta es una integración de cliente independiente para el servidor MCP oficial de Stripe (consulta NOTICE).