# remotion-mcp-server

An MCP App that **creates HTML/CSS animations on the fly**, previews them in an
iframe, and lets you **download** the `.html` file.

No Remotion SSR, no Chromium, no AWS. The server only generates small HTML
files — all motion runs in the browser (inside the MCP App iframe).

## Setup

```bash
pnpm install
pnpm dev
```

| Endpoint | Purpose |
|---|---|
| `/mcp` | MCP endpoint |
| `/files/<id>` | Preview animation (inline HTML) |
| `/files/<id>?download=1` | Download `.html` |
| `/health` | Health check |

## Live (Railway)

- **MCP:** `https://remotion-production-d133.up.railway.app/mcp`
- **Health:** `https://remotion-production-d133.up.railway.app/health`

## Templates

| ID | What it makes |
|---|---|
| `TitleCard` | Title + subtitle with accent bar |
| `KineticText` | Word-by-word kinetic typography |
| `LowerThird` | Name / role lower-third |

## MCP Tools

### `render_animation` (primary App tool)

Generate the HTML animation and open the preview UI with Download.

### `list_templates` / `list_assets` / `get_download_url` / `browse_assets`

Supporting tools for schemas, JSON listing, and reopening the gallery.

## Client Configuration

```json
{
  "mcpServers": {
    "remotion": {
      "type": "streamable-http",
      "url": "https://remotion-production-d133.up.railway.app/mcp"
    }
  }
}
```