What is the MockupStudio MCP server?
MockupStudio is a macOS app that composites a screen recording onto a 3D device model, then animates and renders it as a promo video. Its MCP server, a Rust binary built from the mcp-server folder, bridges to the running desktop app over WebSocket, so an agent can create a scene, add a layer, set keyframes and trigger a render from one plain request.
MockupStudio is a desktop app that drops a screen recording onto a 3D device model, such as an iPhone or MacBook, then lets you animate the camera and export a promotional MP4. The MCP server is a separate Rust binary that bridges to the running app over WebSocket.
Through that bridge, an agent can describe a scene in one request, such as an iPhone with a zoom animation, and the server turns it into the actual layers, keyframes and render call inside the app.
What you can ask it to do
- List the available device models, then create a scene around one of them.
- Add a layer, such as a screen recording, image, text or arrow, onto the 3D device in that scene.
- Set keyframes with an easing preset, linear, ease-in, ease-out, spring or bounce, to animate the camera or a layer.
- Trigger a render once the scene and animation are set, producing an MP4 through the app's FFmpeg export pipeline.
What it needs to run
| MockupStudio MCP server | |
|---|---|
| Platform | macOS on Apple Silicon, currently the only supported target |
| Build tools | Rust 1.75 or later, run cargo build --release in the mcp-server folder |
| App dependency | The MockupStudio desktop app, built with Node 20 and FFmpeg, must be running |
| Status | Pre-1.0; no undo history yet, and H.264 MP4 is the only export format so far |
Who it is for
Best for
- Marketers and developers on Apple Silicon who want an agent to script a device mockup video instead of hand-animating the camera and layers.
- App Store or product pages that need a quick promo clip for a listed device such as an iPhone 16 Pro or an iPad Air.
- Teams comfortable with a pre-1.0 tool and a manual Rust build in exchange for programmatic control over the render.
Not for
- If the output is a social post or banner image rendered as a scene rather than a device mockup video, Keyline MCP Server renders that scene without a device model.
- When the source screens come from a Stitch project rather than a 3D device scene, Stitch Remotion Skill renders that walkthrough video with its own zoom effects.
- If what the page needs is a real 3D scene built in Three.js rather than a rendered mockup video, Three.js WebGL Skill sets up those 3D scenes directly.
- When the motion needs GSAP-driven rules for a video composition scene rather than a device mockup, HyperFrames Animation Skill covers that motion and scene setup instead.
Use it with UiChemy
MockupStudio renders a standalone promo video, outside any web page. Once that video or its poster frame is ready, UiChemy Composer can place it inside an editable WordPress page. Click Get Started on uichemy.com.
Connect MockupStudio MCP: Script 3D Device Mockup Videos to your AI client
cargo build --releaseClone and build the server
Clone the repository, then run
cargo build --releaseinside the mcp-server folder. The binary lands at mcp-server/target/release/mockup-studio-mcp.Add the config to your agent
Put the config block above into ~/.claude/mcp.json for Claude Code, with the real absolute path to the binary you just built.
Run the desktop app
Start the MockupStudio app itself, since the MCP server only bridges to it over WebSocket and needs it running to do anything.
Describe a scene
Ask for something like a scene with an iPhone 16 Pro, a screen recording as the main layer, a slow zoom from 100 to 130 percent over 4 seconds, exported at 1080p60.
Client configuration
{
"mcpServers": {
"mockup-studio": {
"command": "/absolute/path/to/mockup-studio/mcp-server/target/release/mockup-studio-mcp"
}
}
}Endpoints and ports
cargo build --releaseCompiles the MCP server binary inside the mcp-server folder.WebSocketConnects the compiled MCP server to the running desktop app.What you can do with it
- End-to-end scene scriptingAn agent can list devices, build a scene, add layers and set keyframes in sequence from one plain request.
- WebSocket bridgeThe MCP server talks to the running desktop app over WebSocket rather than operating headlessly on its own.
- Real device framesCovers current iPhone, Samsung Galaxy, Pixel, iPad, MacBook and Apple Watch models, with a procedural fallback for anything not on that list.
- Keyframe easing presetsLinear, ease-in, ease-out, spring and bounce presets cover common camera and layer motion without hand-tuning curves.
- Visual effects per layerSpotlights, blur and zoom regions can be applied to a layer alongside the base screen recording or image.
- FFmpeg exportRenders go through an FFmpeg pipeline to produce an MP4, the only export format the project currently supports.
Tools it exposes
List devices
Returns the available 3D device models the app can composite a scene around.
Create scene
Starts a new scene around a chosen device model.
Add layer
Adds a screen recording, image, text or arrow layer onto the device in the current scene.
Set keyframe
Sets a keyframe with an easing preset for camera or layer animation.
Trigger render
Starts the FFmpeg export pipeline to produce an MP4 from the current scene.
Frequently asked questions
What is the MockupStudio MCP server?
It is a Rust binary that bridges an AI agent to the MockupStudio desktop app over WebSocket, exposing tools to list devices, create a scene, add layers, set keyframes and trigger a render of a 3D device mockup video.
How do I set up the MockupStudio MCP server?
Clone the repository, run cargo build --release inside the mcp-server folder, then point your agent's MCP config, such as ~/.claude/mcp.json, at the compiled binary's full absolute path on your own disk.
Does the MCP server work without the desktop app open?
No. It only bridges to a running copy of the MockupStudio app over WebSocket, so the app needs to be open before an agent can create a scene or trigger a render through it.
Which platforms does MockupStudio support?
macOS on Apple Silicon is the only supported platform right now. The project states plainly that Windows and Linux have not been tested at all, so there is no cross-platform path to rely on yet.
Which device models can I use in a scene?
Current iPhone, Samsung Galaxy, Google Pixel, iPad, MacBook and Apple Watch models ship with real 3D frames, and the app falls back to a procedural device shape for anything not on that specific list.
What export formats does it support?
Only H.264 MP4 through an FFmpeg pipeline right now. The project notes ProRes support is planned but not yet available, so plan around MP4 output for any render you trigger today.
Does MockupStudio work with agents other than Claude?
The README documents the config path for Claude Code specifically, but the server itself is a standard MCP binary reachable by any MCP-capable client pointed at the same compiled path.


