# Screenplay (MCP server)

> Screenplay is an MCP server that adds web browsing tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Beautiful screen recordings of any website or desktop app, scripted by your agent. It has 122 GitHub stars, is released under the MIT license and runs locally with npx -y agent-screenplay.

Create beautiful screen recordings with one prompt. Any website, yours or someone else's, or any desktop app. Works with Claude Code, Codex, Cursor and any MCP client.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/gmpetrov/agent-screenplay |
| GitHub stars | 122 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: agent-screenplay |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Web & browsing |
| Latest release | v0.1.7 (Nov 3, 2026) |
| Last commit | Nov 12, 2026 |
| MCP registry name | io.github.gmpetrov/agent-screenplay |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "screenplay": {
      "command": "npx",
      "args": [
        "-y",
        "agent-screenplay"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio screenplay -- npx -y agent-screenplay
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "screenplay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agent-screenplay"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "screenplay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agent-screenplay"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Similar MCP servers

- [Scrapegraph MCP](https://appsgit.com/mcp-servers/scrapegraph-mcp): AI-powered web scraping and data extraction capabilities through ScrapeGraph API. (122 stars, MIT)
- [FrankenSurf](https://appsgit.com/mcp-servers/frankensurf): Read any web page and search the web: 28 tools, cheapest first, every page checked. (119 stars, Apache-2.0)
- [Three.js DevTools MCP](https://appsgit.com/mcp-servers/three-js-devtools-mcp): Inspect and edit Three.js scenes, materials, shaders, lights in real time from any AI agent. (130 stars, MIT)
- [MCP Screenshot Website Fast](https://appsgit.com/mcp-servers/mcp-screenshot-website-fast): Quickly screenshots webpages and converts to an LLM friendly size. (111 stars, MIT)
- [Fitter](https://appsgit.com/mcp-servers/fitter): Turn any website or API into structured JSON with LLM-authored declarative scraping configs. (133 stars, MIT)
- [Oxylabs MCP](https://appsgit.com/mcp-servers/oxylabs-mcp): Fetch and process content from specified URLs & sources using the Oxylabs Web Scraper API. (106 stars, MIT, official, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/screenplay
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
