mcpbeat Sign in

Screenplay MCP Server

local only

Screenplay runs on your own machine — the client starts it, so there is no endpoint to ping. 1 782 installs a week from npm. Last commit 3 Nov 2026.

Beautiful screen recordings of any website or desktop app, scripted by your agent.

Installs per day peak 391 · avg 13
a month agotoday
1 782
Installs / week
npm · agent-screenplay
92
Stars
0 open issues
3 Nov 2026
Last commit
from GitHub
MIT
License
TypeScript

What the code does

We read the source, 3 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

    const probe = spawnSync(process.platform === "win32" ? "where" : "which", ["agent-desktop"], { encoding: "utf8" });
      if (rel) return path.join(dir, rel);
    win.innerHTML = html;

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add agent-screenplay -- npx -y agent-screenplay
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "agent-screenplay": {
      "command": "npx",
      "args": [
        "-y",
        "agent-screenplay"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.agent-screenplay]
command = "npx"
args = ["-y", "agent-screenplay"]
.cursor/mcp.json
{
  "mcpServers": {
    "agent-screenplay": {
      "command": "npx",
      "args": [
        "-y",
        "agent-screenplay"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "agent-screenplay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agent-screenplay"
      ]
    }
  }
}

Alternatives to Screenplay

same job, measured the same way
Screen Browser
by screenbrowser

Your coding agent records a demo or tutorial video of your web app.

answering
Pointframe MCP Server
by dimitar-radenkov

Windows screenshots, OCR, and redacted screen recording for AI agents. No desktop app needed.

local only
Deskwright
by tristanmuzzu

Agents use real GNOME/Wayland apps: on your screen, or an invisible second desktop you never see

103 installs/wk local only
Ember Websites
by embersites

Describe your business. Get a beautiful website, built and published for you from Claude or ChatGPT.

answering
SEOReport
by seoreport

Run full technical SEO audits of any website from your AI agent and get structured findings back.

answering
TileSet
by tileset

Live social feeds and review widgets for any website, set up by your AI agent.

answering
UXKIN
by uxkin

Real UI references for coding agents: iOS app screens, user journeys and website design systems.

answering
StoryCapture
by storycaptures

Write, rehearse, record and publish website demo videos, from the desktop app or the cloud.

270 installs/wk answering

Screenplay — questions

Answers built from our own checks of this server.

Why is there no uptime for Screenplay?
Screenplay runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package agent-screenplay was installed 1 782 times last week.
How do I connect Screenplay?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls agent-screenplay straight from npm; nothing to host, nothing to sign up for.
How many people use Screenplay?
The npm package agent-screenplay was installed 1 782 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Screenplay open source?
Yes — it is published under the MIT licence, written in TypeScript and 92 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.