Paraplex Mcp

ai.paraplexPublished by paraplex.aiv0.3.0Updated Nov 3, 2026

Build and edit 3D motion design scenes in your open Paraplex tab, look at frames, and export.

VerifiedSTDIODesktop onlyDeveloper ToolsMedia & Design

Overview

AI-generated overview

Connects an MCP client to your open Paraplex browser tab so an assistant can build and edit 3D motion design scenes, inspect frames, and export files.

What you can do
  • Check and attach to the open Paraplex tab, then read the scene, its layers, timing and layout facts
  • Start work from a blank project or a built-in template, and list or run the editor's own editing tools such as build_scene, add_text, set_keyframes and add_camera_move
  • Move the playhead and look at the piece as frames, frame sets, PNG stills or review sheets and artboard checks
  • Export images or videos with format, scale, frame rate, time range and transparency options, and render one variant per row of data
  • Import local files (images, video, audio, 3D models, Lottie, Figma frames, SVG, fonts) and HyperFrames projects
  • Manage projects, design systems and skills, and undo or redo edits
When to use it
Useful when you already work in Paraplex and want a terminal-based agent to draft, revise and export motion design pieces in your own tab, checking the result visually as it goes. It is not a headless renderer: it needs an open Paraplex tab in a supported browser.
Requirements
A local process started with npx (Node.js). An open Paraplex tab at app.paraplex.ai in Chrome, Edge or Arc, connected via Menu › Connect an agent with the port and six-digit code. The server listens on localhost port 47821 by default, and the browser may ask to allow local network access. Exports go to ./paraplex-exports or the PARAPLEX_OUT_DIR directory.
Before you install
The agent can edit, save and overwrite projects in your tab and write export files to disk, though each edit is one undo step. It reaches whatever you are signed in to in that tab. AI used inside Paraplex is metered by your Paraplex plan. Only connect a tab you trust, and disconnect from the banner when done.

Installation

In SourceWeft

  1. Open Paraplex Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

paraplex-mcp

Connect Claude Code — or any MCP client — to the Paraplex 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

ToolWhat it does
connectionWhether a tab is attached; if not, the port and code to give you
sceneThe open scene: canvas, duration, time, every layer
list_tools, run_toolThe assistant's verbs (build_scene, add_text, set_keyframes, add_camera_move…) and running one
list_templates, apply_template, new_projectStart from a template or a blank file
set_time, frame, frames, export_pngLook at the piece at any time, as its export draws it
scene_factsWhere every layer lands in the frame, type sizes on the frame, the camera
exportExport 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_variantsA render per row of data (rows or CSV), each column filling the layer of its name
export_videoThe video at the scene's own settings (kept from 0.2)
import_fileSend 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_hyperframesBring in a HyperFrames project from a folder or .zip on this computer: one code layer, its sound on the timeline
undo, redoStep back or forward, as ⌘Z does
review_sheet, review_artboardsFrames 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_projectYour projects in this browser and your account; open one, or save the scene as one
list_design_systems, apply_design_systemParaplex's design systems and yours; apply one in a single undo step
list_skills, load_skill, read_skill_file, write_skillThe 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

Source: README.md at commit 68f2a85

Tools

30

connection

Whether a Paraplex tab is attached, and if not, what to tell the person: in Paraplex, Menu → Connect an agent, then this port and code. Call it first; say the code to the person exactly.

Takes no parameters.

list_templates

The built-in templates: id, label and categories (the first is its section on the home page, e.g. app-promo, brand-promo, starter, website-hero-visuals, titles-text, infographics).

Takes no parameters.

new_project

A blank 1920×1080 project in the attached tab (the scene being left is saved as the editor saves it).

Takes no parameters.

apply_template

Apply a built-in template by id, as the gallery does.

Parametersidrequired

scene

The open scene: canvas, duration, current time, and every layer with its kind, name, clip and parent.

Takes no parameters.

set_time

Move the playhead to a time in seconds.

Parameterssecondsrequired

frame

A picture of the frame at a time (or the current one), through the export path — the way to look at what you made.

Parametersseconds

frames

The frame at several times (default: four across the piece), one picture each.

Parameterstimes

list_tools

The assistant's tools — every verb that edits the scene — with their input schemas. Run one with run_tool.

Takes no parameters.

run_tool

Run one of the assistant's tools in the attached tab (see list_tools), e.g. build_scene, add_text, set_property, add_camera_move — each call one undo step there.

Parametersnamerequiredinput

export_png

The scene at the current time through the export path (what a PNG export produces), as an image.

Takes no parameters.

export

Export with any of the Export section's options, the files written on this computer as the tab renders them (no size limit): an image (png, jpg) at `seconds`, or a video (mp4, webm, gif, png-sequence) over `inSeconds`–`outSeconds`; `scale` 0.5–4, `fps`, `background: false` for transparency (PNG, WebM, PNG sequence); `artboard` an artboard's id or label, or "all" for one file each; `deliver` a destination's preset (app-store with `device` iphone/ipad/mac, keynote, powerpoint, google-slides). Only what you pass changes, and only for this export: the person's settings stay. `path` is a folder, or a file name for a single file (default ./paraplex-exports). A Free account gets the reason a Pro export is refused.

ParametersfpskindpathscaledeviceformatdeliversecondsartboardinSecondsbackgroundoutSeconds

render_variants

Render a variant per row, as Variants does: `rows` (objects) or `csv` (a header row, then a row per variant). Each column fills the layer named like it — its text, a counter's end value, a fill color, or a picture by its file name in the scene's media library — or the layer `bindings` maps it to (column → layer id or name). `nameColumn` names each file. Takes every option `export` takes (an image by default; kind video for a clip per row). Without rows, the sheet already set in Variants. Answers with the files and any column that bound to nothing.

ParameterscsvkindpathrowsformatoptionsbindingsnameColumn

export_video

Export the scene as a video with its own settings, written to a file in the export folder (or at `path`); answers with where it went. The `export` tool takes every option.

Parameterspath

import_hyperframes

Import a HyperFrames project (HeyGen's HTML-to-video format) into the attached tab: `path` is its folder (index.html at the top) or a .zip of it. The whole project becomes one code layer — nested data-composition-src files, pictures, videos, fonts and stylesheets embedded, HyperFrames' runtime driven by the playhead — and each <audio> clip a sound layer at its start. Then look at it with frames, and finish it by hand or with run_tool.

Parametersnamepathrequired

import_file

Bring a file from this computer into the open scene, as dropping it on the canvas does: a picture or video becomes a layer (or fills the layer `target`, by id — a card, a phone screen, a component's slot), sound a clip at the playhead, a GLB/glTF/splat a model, a .lottie or Lottie .json an animation, an SVG a vector, a TTF/OTF/WOFF a font of the scene's. Answers with what happened and the layers it added.

Parameterspathrequiredtarget

undo

Undo the last `steps` edits in the tab (default 1), as ⌘Z does — a run_tool call is one step. Answers with how many it took and whether more remain.

Parameterssteps

redo

Redo `steps` undone edits (default 1), as ⇧⌘Z does.

Parameterssteps

review_sheet

A review sheet of the open scene, the way to judge a piece before calling it done: frames across it (default eight; or `times`) as one picture, and the flags — layers past the frame (more than 0.05 of the frame), text under 14 px on the frame, text under 3:1 contrast against what is behind it, motion hitches (a speed that jumps or a path that turns a corner mid-move). Fix what is flagged unless it is a deliberate choice you can name.

Parameterstimeswidth

review_artboards

The piece on every review artboard (9:16, 4:5, 1:1, 16:9) as Responsive lays it out, at `times`: what each artboard did, what its frame cuts, the smallest type and type at the edge, with all the frames as one picture.

Parameterstimes

list_projects

The person's projects, newest first: those in this browser and, when the tab is signed in, those kept in their account (in the cloud), each with its id, name, when it changed, and which one is open.

Takes no parameters.

open_project

Open one of the person's projects by id (list_projects), as the editor opens it: the scene being left is saved first; a project kept only in the account is fetched. Answers with its name and its scene.

Parametersidrequired

list_design_systems

Design systems the person can apply: Paraplex's and their own (made, imported or installed), each with what it holds (colors, text styles, materials, looks, fonts), and the one the scene follows now.

Takes no parameters.

apply_design_system

Apply a design system by id or name, as Use in project does: its colors, text styles, materials, looks and fonts merged into the scene, which then follows it. One undo step. Then build with its tokens (run_tool get_brand reads them).

Parametersidrequired

list_skills

The person's skills and Paraplex's (Agent Skills: instructions and reference files), each with its description and whether it is on. Read one with load_skill when a task matches it.

Takes no parameters.

load_skill

A skill's instructions (its SKILL.md body) and the files inside it, by name. Read it before doing the work it describes.

Parametersnamerequired

read_skill_file

One file inside a skill — a reference, a template, a checklist — by the path load_skill listed.

Parametersnamerequiredpathrequired

write_skill

Write a skill's SKILL.md into the person's library: the whole file, frontmatter (name, description) then instructions. Rewrites the named skill's SKILL.md and keeps its reference files, or creates it. Paraplex's own skills are not rewritten.

Parametersnamerequiredmarkdownrequired

save_project

Save the open scene as a project of that browser's, by name.

Parametersnamerequired

scene_facts

The review's facts at a time: where every layer lands on the frame (NDC boxes, ±1 is the frame's edge), each text's size on the frame in px and its fill, the camera.

Parameterssecondsrequired

Version history

2
  1. v0.3.0LatestOct 31, 2026
  2. v0.2.1Oct 14, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts