# reelo-mcp

Servidor MCP de **Reelo** para crear tableros, cotizar y generar videos con IA desde cualquier cliente MCP (Claude Desktop, Cursor, ChatGPT y otros), usando los créditos de tu cuenta Reelo.

*English below.*

> **Créditos:** cotizar, crear tableros, recrear desde un link y planear ediciones no consume créditos. `run_quote` **sí consume créditos Reelo** de tu cuenta (se reservan al iniciar y se devuelven si la generación falla). Si no te alcanzan, recarga o elige un plan en https://www.getreelo.com/account?tab=plan

## Requisitos
- Node.js 18 o superior
- Una clave de API de Reelo (`rk_live_…`): **Cuenta › API y MCP** en https://www.getreelo.com

## Configuración

### Claude Desktop
`claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "reelo": {
      "command": "npx",
      "args": ["-y", "@getreelo/reelo-mcp"],
      "env": { "REELO_API_KEY": "rk_live_TU_CLAVE" }
    }
  }
}
```

### Cursor
`~/.cursor/mcp.json` (o `.cursor/mcp.json` en tu proyecto): el mismo bloque `mcpServers` de arriba.

### ChatGPT y otros clientes MCP
- Clientes con stdio: comando `npx -y @getreelo/reelo-mcp` con la variable `REELO_API_KEY`.
- Clientes que solo aceptan MCP remoto (HTTP), como los conectores de ChatGPT: usa el endpoint alojado que aparece en la documentación de la API de Reelo (https://www.getreelo.com/developers) con tu clave como `Authorization: Bearer`.

### Variables
| Variable | Requerida | Descripción |
|---|---|---|
| `REELO_API_KEY` | sí | Tu clave de API de Reelo |
| `REELO_API_URL` | no | URL base de la API (por defecto la URL pública v1 de Reelo) |

## Herramientas
| Herramienta | Qué hace | Créditos |
|---|---|---|
| `list_boards` | Lista tus tableros | no |
| `create_board` | Crea un tablero | no |
| `get_board` | Un tablero y sus piezas | no |
| `quote_video` | Cotiza: `tier` (economico/profesional), `resolution` (720p/1080p), `duration_target` (auto/15/30/60), `look`, `voice_id`, `block` (capítulo 15/30/60 s o escena 5/10/15 s: la duración es por bloque) | no |
| `run_quote` | Ejecuta una cotización con `max_credits` | **sí** |
| `get_run` | Estado, cobro y resultados | no |
| `get_run_assets` | Links temporales de descarga | no |
| `recreate_from_link` | Estructura de escenas para recrear un video desde un link (15 o 30 s, sin descargarlo) | no |
| `plan_edit` | Planea un nodo Editar: unir, cortar, texto, subtítulos, música bajo la voz… Con `output_seconds` (máx. 100) y `ratios` devuelve `render_quote`: el precio del render en créditos | no |

Flujo típico: `create_board` → `quote_video` → confirmas el precio → `run_quote` → `get_run` → `get_run_assets`.

## Errores
- **401**: clave faltante o revocada.
- **402**: créditos insuficientes o tope mensual de la clave → https://www.getreelo.com/account?tab=plan
- **409**: cotización vencida o usada; pide una nueva.
- **429**: más de 60 solicitudes por minuto.

## Proyecto hermano
¿Solo quieres editar video localmente, sin cuenta? Mira **[video-edit-mcp](https://github.com/Galvez92/video-edit-mcp)**.

---

## English

MCP server for **Reelo**: create boards, quote and generate AI videos from any MCP client, billed to your Reelo credits.

> **Credits:** quoting, boards, recreate-from-link and edit planning spend nothing. `run_quote` **spends Reelo credits** (held at start, refunded if the run fails). Top up or choose a plan at https://www.getreelo.com/account?tab=plan

**Setup:** get an API key under **Account › API & MCP** at https://www.getreelo.com, then add to Claude Desktop / Cursor:
```json
{ "mcpServers": { "reelo": { "command": "npx", "args": ["-y", "@getreelo/reelo-mcp"], "env": { "REELO_API_KEY": "rk_live_YOUR_KEY" } } } }
```
Other stdio clients: run `npx -y @getreelo/reelo-mcp` with `REELO_API_KEY`. Remote-only clients (e.g. ChatGPT connectors): use the hosted MCP endpoint listed in the Reelo API docs (https://www.getreelo.com/developers). Optional `REELO_API_URL` overrides the API base URL.

**Tools:** `list_boards`, `create_board`, `get_board`, `quote_video`, `run_quote` (spends credits), `get_run`, `get_run_assets`, `recreate_from_link`, `plan_edit`.

`quote_video` accepts `block` to quote one chapter (15/30/60 s) or one scene (5/10/15 s) of a multi-part project; the length is per block. `plan_edit` accepts `output_seconds` (max 100) and `ratios` and returns `render_quote`, the render price in whole credits.

**Sibling project:** [video-edit-mcp](https://github.com/Galvez92/video-edit-mcp) for local video editing without an account.

## Desarrollo / Development
```bash
npm install
npm test   # build + tests con fetch simulado / mocked fetch, no credits spent
```

## Licencia / License
MIT