# paraplex-mcp

Connect Claude Code — or any MCP client — to the [Paraplex](https://paraplex.ai)
tab you have open. Paraplex is a 3D motion design studio in the browser, with an
AI assistant that edits real layers and keyframes. With this server, an agent in
your terminal can build and change scenes in your tab with the same tools the
assistant uses, look at frames as it goes, and export.

```bash
claude mcp add paraplex -- npx -y paraplex-mcp
```

Then ask Claude Code for a piece — "a 10-second launch video with three glass
cards and our logo" — and it will tell you how to connect:

1. Open Paraplex at <https://app.paraplex.ai>.
2. **Menu › Connect an agent**, and enter the port and the six-digit code Claude
   Code gives you.

A banner shows in your tab while an agent is connected; disconnect it there any
time.

## What it can do

| Tool | What it does |
| --- | --- |
| `connection` | Whether a tab is attached; if not, the port and code to give you |
| `scene` | The open scene: canvas, duration, time, every layer |
| `list_tools`, `run_tool` | The assistant's verbs (`build_scene`, `add_text`, `set_keyframes`, `add_camera_move`…) and running one |
| `list_templates`, `apply_template`, `new_project` | Start from a template or a blank file |
| `set_time`, `frame`, `frames`, `export_png` | Look at the piece at any time, as its export draws it |
| `scene_facts` | Where every layer lands in the frame, type sizes on the frame, the camera |
| `export` | Export to a file on this computer (`./paraplex-exports`, or `PARAPLEX_OUT_DIR`) with any of the Export section's options for that export only: image or video, format, scale, frame rate, part of the timeline, no background, one artboard or all, App Store / Keynote / PowerPoint / Google Slides presets. Large files stream in pieces, so there is no size ceiling |
| `render_variants` | A render per row of data (rows or CSV), each column filling the layer of its name |
| `export_video` | The video at the scene's own settings (kept from 0.2) |
| `import_file` | Send a file from this computer into the scene, as a drop takes it: a picture or video, sound, a 3D model, Lottie, Figma frames, an SVG, a font |
| `import_hyperframes` | Bring in a HyperFrames project from a folder or .zip on this computer: one code layer, its sound on the timeline |
| `undo`, `redo` | Step back or forward, as ⌘Z does |
| `review_sheet`, `review_artboards` | Frames across the piece as one sheet, with what runs past the frame, small or low-contrast type, and motion hitches; or the piece on 9:16, 4:5, 1:1 and 16:9 |
| `list_projects`, `open_project`, `save_project` | Your projects in this browser and your account; open one, or save the scene as one |
| `list_design_systems`, `apply_design_system` | Paraplex's design systems and yours; apply one in a single undo step |
| `list_skills`, `load_skill`, `read_skill_file`, `write_skill` | The assistant's skills: read them, or write one into your library |

Every edit lands in your tab as one undo step, so you can step back through
anything the agent did.

## Privacy and safety

- The server listens on this computer only (port 47821; pass another as
  `npx paraplex-mcp 48000`).
- Only a Paraplex page can connect, and only with the one-time code.
- Nothing is sent anywhere else: the scene stays in your tab, exports are
  written where you ran the server, and a file you send in goes only to your
  tab. An agent reaches only what you are signed in to in that tab.
- AI used inside Paraplex is metered by your Paraplex plan as usual; the agent's
  own model is your Claude Code's.

## Browsers

Chrome, Edge or Arc (other browsers may not let a website reach your own
computer). If your browser asks to let app.paraplex.ai connect to devices on
your local network, allow it: that is this server.

## License

MIT © Paraplex Digital, LLC