Screenplay MCP
Screenplay films screen recordings from one prompt: the agent writes a scenario, the tool plays and edits it.
- 115 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Scenario steps perform real clicks and input on a site or app, including form submission.
- Chromium is downloaded on first run.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/screenplayDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Scenario steps perform real clicks and input on a site or app, including form submission.
- Chromium is downloaded on first run.
This is third-party code. Review the repository files before installing.
What it does
An MCP server and CLI for video demos of websites and apps. The agent explores a site or app and writes a JSON scenario: `click`, `type`, `hover`, `scroll` steps, captions, callouts, highlights and title cards. Screenplay plays the scenario in a browser or desktop app, films it and edits the video in a Screen Studio style: smooth cursor, automatic zooms following the action, click effects, titles and optional voice-over. The program itself contains no AI and needs no model key: the agent thinks while Screenplay films and edits. The output is an MP4 at 1920x1080 and 30 fps by default plus a storyboard. The `check`, `record`, `render` and `style` commands work without MCP too. The server is in the official MCP registry.
Who it is for. Product teams and developers who need quick feature demo videos, tutorials and screen recordings without manual editing.
Good fit when
- A 30-second walkthrough of a site from a link is wanted.
- You need to show inviting a teammate in an app with a French voice-over.
- A scenario should be tested fast, without filming, with `check`.
- A finished clip must be re-edited in another style without refilming.
Not a fit when
- Clicks cannot run on a real account: `check` and `record` perform steps for real.
- You need live editing with manual timeline work.
- Node.js 20 is not available on the machine.
Example request
/screenplay Make a 30-second walkthrough of https://askli.co with voice-over and show the storyboard.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
The `check` and `record` steps really perform actions: clicking "Send" sends data, so point scenarios at a demo account or staging environment. Installation needs Node.js 20, and Chromium is downloaded on first run. `npx agent-screenplay init` adds the MCP server to detected agents and installs the scenario guide, after which you restart the agent. Voice-over and styles are configured separately. For desktop apps coordinate targets are only a fallback.
How to disable. Remove the MCP entry from the agent configuration and the package with `npm uninstall -g agent-screenplay` if installed globally. Delete the downloaded Chromium and created videos by hand.
FAQ
How do I install it?
Run `npx agent-screenplay init`. It downloads Chromium, adds the MCP server to detected agents and installs the guide.
How do I run it in Claude Code?
Type `/screenplay` and say what to film, for example a 30-second walkthrough from a link.
Is a model key needed?
No, Screenplay contains no AI. Your agent writes the scenario.
How do I re-edit without refilming?
`npx agent-screenplay render demo.json` re-edits the last take with a new style, zoom, text and voice.
What is the output?
An MP4 up to 4K and 24 to 60 fps, 1920x1080 at 30 by default, plus a storyboard and an optional GIF.
Discussion
No questions or reviews yet.
Related
MCP serversOpenScreen MCP: an agent records the screen, trims and zooms frames, adds captions and exports MP4 or GIF.
ClipForge MCP
ClipForge
ClipForge MCP builds a vertical video from a topic or a product link: stock footage, Edge TTS voiceover and captions, no keys, composed with FFmpeg
An MCP server with 59 tools for CapCut and OpenCut editing: tracks, clips, text, transitions and voiceover from Cursor and Codex.
An Excalidraw MCP server: the agent draws a diagram and adds keyframe animation while you watch it assemble live in the browser
MCP server and panel let an agent read an Adobe After Effects comp and build animation as ordinary editable layers and keyframes.
MCP server of the 37Studio video studio: an agent manages brands, makes videos, posts to social networks and answers messages.
README in short
The README shows the one-prompt idea, installation, use in Claude Code, Codex and Cursor, CLI commands, the scenario format with an example and styles. It warns that steps run for real.