What it does
clickcast drives a real browser through a website and returns a watchable reel (GIF, MP4, WebP, or raw frames) plus a JSON sidecar. The sidecar records each step's selector, timings, frame paths, discovered elements, and post-action page state, including title, URL, console errors, and failed requests. In MCP mode it performs one action at a time, such as goto, click, type, or scroll, and returns an annotated frame, page state, grid coordinates, and an error code, so an agent can react before choosing its next step.
Use the MCP server when an agent needs to explore and respond live. Use auto or scenario runs for repeatable, one-shot artifacts such as CI checks, documentation, or release notes. Auto mode discovers interactive elements and builds a tour from a URL, scenario mode follows a YAML script, shot captures a single screenshot, and explore maps the app's structure without producing a reel.
Setup means installing the Python package (Python 3.10 or newer), then downloading Chromium separately, about 180MB, with optional system libraries on Linux. A doctor command checks the setup. Homebrew, apt, and npm packages are also provided, and the npm package wraps the Python one. Commands run headless by default, and tour limits cap steps, pages, duration, and per-click timeout.
Limitations and requirements
Requires Python 3.10 or newer. Chromium is downloaded separately (about 180MB). The --with-deps option for system libraries works on Linux only and may prompt for sudo. The browser-install prompt appears only in an interactive terminal; in CI or scripted runs, a missing browser makes the command fail instead.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.AlexKay28/clickcast
Drive a real Playwright browser: annotated screenshot + structured page state after every action.
v0.4.4As shown on registry.modelcontextprotocol.io when we last read it