# stripe-ops-mcp

MCP server ([Model Context Protocol](https://modelcontextprotocol.io)) que expone operaciones de **Stripe** como herramientas para agentes de IA — Claude Code, Claude Desktop o cualquier cliente MCP.

Nace de mi experiencia operando el vertical de pagos de una fintech: las preguntas que un agente (o un humano de soporte) hace todos los días sobre el camino del dinero, empaquetadas como tools.

## Herramientas

| Tool | Qué hace |
|------|----------|
| `get_customer` | Busca un customer por email o ID, con sus suscripciones y estado |
| `list_recent_charges` | Cargos recientes de un customer: monto, estado, motivo de fallo |
| `find_duplicate_charges` | Detecta posibles **dobles cobros**: cargos exitosos del mismo monto dentro de una ventana de tiempo |
| `revenue_summary` | Total cobrado, reembolsado y tasa de fallo de los últimos N días |

## Uso

```bash
npm install
npm run build
```

Configuración en Claude Code / Claude Desktop (`.mcp.json`):

```json
{
  "mcpServers": {
    "stripe-ops": {
      "command": "node",
      "args": ["/ruta/a/stripe-ops-mcp/dist/index.js"],
      "env": { "STRIPE_API_KEY": "sk_test_..." }
    }
  }
}
```

Y luego, en una conversación con el agente:

> "¿El customer juan@ejemplo.com tiene dobles cobros esta semana?"

El agente encadena `get_customer` → `find_duplicate_charges` y responde con los charge IDs concretos.

## Seguridad

- Usa **llaves de test** (`sk_test_...`) para probar. Si lo apuntas a producción, usa una [restricted key](https://docs.stripe.com/keys#create-restricted-api-keys) de solo lectura.
- Todas las tools son de **solo lectura**: este server no crea, modifica ni reembolsa nada.

## Por qué

Un dashboard responde las preguntas que alguien anticipó; un agente con tools responde las que surgen a las 3am. Este repo es la versión mínima y abierta del patrón que uso en producción: exponer los sistemas de dinero (Stripe, base de datos, Kubernetes) vía MCP para que los agentes monitoreen, diagnostiquen y auditen — con el humano decidiendo.

---

**Juan Carlos Salas** — Fullstack Product Engineer, Payments & Growth · [LinkedIn](https://www.linkedin.com/in/j-charle-salas)

MIT