# Screenplay

This MCP server for Claude Code records a website or desktop app and turns the session into a video. The agent plans the actions; Screenplay captures and styles them.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 133 repo stars
- Author: gmpetrov
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gmpetrov/agent-screenplay
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/screenplay

## What it does

Screenplay turns an agent-written sequence of actions into a screen-recorded video. The agent explores the interface and drafts the steps; the server runs them in a browser or desktop app, records the session, then adds cursor movement, action-following zooms, captions, and optional narration.

A scenario specifies a site address and actions such as navigation, clicks, typing, highlights, and title cards. The `check` command runs the steps without recording, while `render` can restyle a previous take. `check` and `record` execute the actions for real, so a scenario that clicks Send will send the message.

Node 20 or newer is required. Running `init` downloads Chromium; the npm package also carries `ffmpeg` and its drawing library. Screenplay contains no AI of its own and needs no model key.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add agent-screenplay -- npx -y agent-screenplay
```

### Codex

**Platform CLI**
```bash
codex mcp add screenplay -- npx -y agent-screenplay
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "screenplay": {
            "command": "npx",
            "args": [
                "-y",
                "agent-screenplay"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "screenplay": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "agent-screenplay"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add screenplay npx -y agent-screenplay
```

## When to use it
- record a guided walkthrough of a website or app
- turn an agent's action sequence into a video
- add captions, highlights, or narration to a recording
- restyle a video without filming the scenario again

## Example prompts
- Record a walkthrough of inviting a teammate in our app, with French narration.
- Make a video showing how a conversation gets handed to a human agent.
- Create a site walkthrough that highlights the important buttons.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

From the same set: [gmpetrov/agent-screenplay](https://affpapa.org/en/nevibecode/by/gmpetrov/agent-screenplay.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
