npm package: @recaudo/mcp-server
Description: MCP Server for Recaudo - manage payments, invoices, customers, conversations, CRM and more via AI assistants
Author: Recaudo
Latest version: 1.3.0

# @recaudo/mcp-server

Servidor MCP (Model Context Protocol) para [Recaudo](https://recaudo.app) — plataforma de pagos, facturación, CRM y automatización.

Permite a asistentes de IA como Claude Desktop, Cursor y otros clientes MCP gestionar tu negocio directamente: crear facturas, cobrar, enviar WhatsApp, gestionar clientes, CRM y más.

## 110 herramientas disponibles

| Módulo | Herramientas |
|--------|-------------|
| Clientes | Crear, buscar, actualizar, eliminar, métodos de pago |
| Facturas | CRUD completo, parcialidades, moratorios |
| Pagos | Cargos, reembolsos, links de pago |
| Conversaciones | WhatsApp, Instagram, Messenger, templates |
| Cobranza | Facturas vencidas, promesas de pago, intentos |
| CRM | Deals, pipelines, mover etapas |
| Seguimientos | Crear, completar, reprogramar |
| Automatizaciones | Crear reglas trigger→acción |
| Email | Templates, envíos, historial |
| Calendario | Citas, disponibilidad, tipos |
| Facturación electrónica | CFDI, timbrar, cancelar |
| Etiquetas | Tags de clientes y conversaciones |
| Reportes | Generar reportes con lenguaje natural |
| Productos | Catálogo, categorías, inventario |
| Pedidos | CRUD, estados, envío |
| Suscripciones | Planes, cobro recurrente |
| Webhooks | Configurar, probar, historial |

## Configuración rápida

### 1. Obtén tu API Key

Ve a [Recaudo → Configuración → API Keys](https://recaudo.app/admin/settings/api-keys) y genera una Secret Key.

### 2. Configura tu cliente MCP

#### Claude Desktop

Edita `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) o `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "recaudo": {
      "command": "npx",
      "args": ["-y", "@recaudo/mcp-server"],
      "env": {
        "RECAUDO_API_KEY": "sk_live_tu_api_key"
      }
    }
  }
}
```

#### Claude Code

```bash
claude mcp add recaudo -- npx -y @recaudo/mcp-server
```

Luego configura la variable de entorno `RECAUDO_API_KEY`.

#### Cursor

Crea `.cursor/mcp.json` en tu proyecto:

```json
{
  "mcpServers": {
    "recaudo": {
      "command": "npx",
      "args": ["-y", "@recaudo/mcp-server"],
      "env": {
        "RECAUDO_API_KEY": "sk_live_tu_api_key"
      }
    }
  }
}
```

### 3. Reinicia tu cliente y listo

Ahora puedes pedirle a tu asistente de IA cosas como:

- "Muéstrame los últimos 5 pagos"
- "Crea una factura de $5,000 para el cliente Juan Pérez"
- "¿Cuántas facturas vencidas hay?"
- "Envía un WhatsApp al cliente con el template de recordatorio"
- "Crea un seguimiento para llamar a Pedro mañana"
- "Genera un reporte de ingresos del mes"

## Variables de entorno

| Variable | Requerida | Descripción |
|----------|-----------|-------------|
| `RECAUDO_API_KEY` | Sí | Tu Secret Key de la API |
| `RECAUDO_API_URL` | No | URL base (default: `https://recaudo.app/api/v1`) |

## Documentación

- [API Reference](https://recaudo.app/admin/api-keys/docs)
- [MCP Server docs](https://recaudo.app/admin/api-keys/docs#mcp-server)

## Licencia

MIT