# AIOProductOS/studio-mcp [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/AIOProductOS/studio-mcp  
**GitHub Stars:** 3  
**npm Downloads (last month):** 648  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/aioproductos-studio-mcp

## Description
Turns your AI host into a product videographer: scripted screen recordings of your own web app with a visible gliding cursor, camera zooms, highlight callouts, captions, and designed scene transitions, plus marketing-grade screenshots; deterministic dark-frame cleanup and MP4/GIF export. Free and fully local. npx -y @aioproductoscom/mcp-studio

## Tools
Capabilities this server exposes over MCP:

- **studio_start** — Start a recording session: launches a themed headless browser and begins capturing video. Returns the session config and the output directory. One session at a time — studio_finish or studio_cancel ends it. Set theme to the PRODUCT'S brand (bg = its app background — wrong bg causes visible flashes on page loads); use storage_state_path (a Playwright storageState JSON) to record logged-in areas without sharing credentials; list chat widgets / dev overlays / consent banners in hide_selectors so they never appear on tape.
- **studio_goto** — Navigate to a URL behind a designed transition card (eyebrow + big title on the theme background) — the viewer never sees a loading flash or half-hydrated page. Use for the opening shot AND every surface change; give each a short title so the cut reads as a chapter. Waits for real content (network settle + optional wait_for selector + skeleton loaders cleared) before lifting the card.
- **studio_click** — Glide the visible cursor to a target and click it, slow enough to read as a deliberate action on camera. Use for every button / link / menu interaction in the walkthrough. Precondition: the target must be on screen — studio_goto or studio_scroll to it first if it isn't. Prefer a stable CSS selector; fall back to visible text. After clicking it waits for the page to settle and re-applies the theme overlays, so the next beat is on a hydrated page. Returns 'clicked <target>', or errors 'target not visible' — then take a studio_screenshot and pick a better target.
- **studio_type** — Glide to an input and type text at a human pace (keystroke by keystroke — it reads as real usage, not a paste). Use realistic demo content; whatever you type is on tape.
- **studio_scroll** — Cubic-eased scroll to an absolute Y offset or until a target element is in view — never a jump cut. Use between story beats to bring the next area on camera. Side effect: changes only the page scroll position (no click, no navigation). Pass exactly ONE of to_y or to_target. Returns 'scrolled' on completion. To reveal an off-screen element before studio_click or studio_highlight, scroll to it first.
- **studio_caption** — Show (or replace) the bottom-left storyline caption — an eyebrow kicker plus one sentence that narrates the current beat. Keep it under ~12 words and leave it up 2–4s (studio_hold) so it reads. Pass clear=true to fade it out before a scene change. The caption_text is ALSO recorded as the voice-over script: if you call studio_finish with voiceover:true it's spoken aloud (locally) timed to this moment — write captions as speakable sentences. Set no_voice:true for a caption you want on screen but NOT narrated.
- **studio_narrate** — Record a line of voice-over WITHOUT putting a caption on screen — narration spoken over the action. The line is synthesized locally at studio_finish (needs voiceover:true). Holds the shot afterward so there's footage under the line; set hold_ms to roughly the length of the sentence when spoken (~400ms/word).
- **studio_highlight** — Draw an accent ring around a target (CSS selector or visible text), optionally with a label card beside it — the 'look here' callout. Side effects: scrolls the target into view, then overlays a ring (and card) in the theme accent; rings stack until cleared. Returns 'highlighted <target>' when the element is found, or errors 'target not found: <target>' when it isn't — retry with a studio_screenshot to pick a better target. Always call with clear=true before you navigate, zoom, or ring a different element, so stale rings don't linger on the next shot.
- **studio_zoom** — Camera punch-in: smoothly zoom the page toward a target (CSS selector or visible text) — the money shot for a metric, button, or result. Captions stay screen-fixed; the content scales under them. ALWAYS studio_zoom with reset=true before navigating or showing the end card, or the next scene inherits the zoom.
- **studio_hold** — Hold the shot for a moment — glides to a target (optional) and keeps micro-drift so the recorder keeps emitting frames (a dead-static hold gets its tail frames dropped). Use after captions, highlights, and zooms: 2000–3000ms is a good beat.
- **studio_end_card** — Show the closing card — a centred glass card over the (still visible) product: title, optional subtitle and URL. The classic outro: what they saw + where to get it. Hold ~2.5s after this, then studio_finish.
- **studio_screenshot** — Take a high-DPI (2x) screenshot of the current frame and save it as a PNG in the output directory. Works any time during a session — element-only via selector, or full_page for the whole scroll height. Returns the file path. Clear captions/rings first unless you want them in the shot.
- **studio_finish** — Stop recording and produce the final files: closes the browser, strips residual dark frames (ffmpeg blackdetect → trim), transcodes to a share-ready MP4 (H.264, faststart), then — optionally — narrates the caption lines with a LOCAL voice (no cloud/keys), lays down a music bed, writes/burns subtitles, and exports vertical/square social crops, plus a GIF. Voice-over timing is auto-corrected for the frames the deblack step removed. Returns every produced file with size + duration. Without ffmpeg you still get the raw WebM.
- **studio_cancel** — Abandon the current recording session: closes the browser and discards the tape. Nothing is written except screenshots already saved. Safe to call when no session is active (no-op).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "studio-mcp": {
    "command": "npx",
    "args": ["-y","@aioproductoscom/mcp-studio"],
    "env": {
      "STUDIO_STORAGE_STATE_PATH": ""
    }
  }
}
```

**Requires environment variables:** `STUDIO_STORAGE_STATE_PATH` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

# AIOProductOS Studio · MCP

Your AI teammate becomes your **product videographer**. Studio is an MCP server
that records scripted walkthroughs of **your own web app** — a visible cursor
that glides to every click, camera punch-ins, highlight callouts, storyline
captions, designed scene transitions — and takes marketing-grade screenshots.
Tell your AI host what story to shoot; get back a share-ready MP4.

The videos PMs hate making — demo clips, explainers, changelog GIFs, launch
screenshots — become one prompt.

**Free · MIT · runs 100% locally** (your browser, your URLs, your logged-in
session — nothing is uploaded anywhere). By [AIOProductOS](https://aioproductos.com),
built from the same pipeline we use for our own launch videos.

## Install

```bash
# Claude Code
claude mcp add studio -- npx -y @aioproductoscom/mcp-studio

# Cursor / Codex — .mcp.json
{ "mcpServers": { "studio": { "command": "npx", "args": ["-y", "@aioproductoscom/mcp-studio"] } } }
```

Requirements: Node 18+, Playwright Chromium (`npx playwright install chromium`,
one-time), and ffmpeg on PATH for MP4/GIF export (`brew install ffmpeg` — without
it you still get the raw WebM).

## Use

Then just direct the film:

> "Record a 30-second walkthrough of https://app.example.com — theme it to our
> brand (#0d1117 bg, #f97316 accent), open on the dashboard with the title
> 'Meet Example', caption the three key features, zoom in on the analytics
> chart, and end with 'Start free · example.com'. Also grab a hero screenshot."

Your host runs the shoot tool by tool; files land in `./studio-output/`.

## The tools

| Tool | What it does |
|---|---|
| `studio_start` | open a themed recording browser (viewport, brand colors, logged-in state) |
| `studio_goto` | navigate behind a designed title card — no loading flashes on tape |
| `studio_click` / `studio_type` | cursor glides to the target; typing is human-paced |
| `studio_scroll` | cubic-eased scroll, never a jump cut |
| `studio_caption` | bottom-left storyline caption (the "voiceover" in text) |
| `studio_narrate` | spoken voice-over with NO on-screen caption; holds the shot under the line |
| `studio_highlight` | accent ring + label callout around any element or visible text |
| `studio_zoom` | smooth camera punch-in on a metric, button, or result |
| `studio_hold` | hold the shot (micro-drift keeps frames flowing) |
| `studio_end_card` | closing glass card: title, subtitle, CTA URL |
| `studio_screenshot` | high-DPI PNG of the frame, an element, or the full page |
| `studio_finish` | stop, auto-remove dark frames, export MP4 (+ optional GIF) |
| `studio_cancel` | abandon the take |

## Recording logged-in areas

Studio never sees your credentials. Save a [Playwright storageState](https://playwright.dev/docs/auth)
once (`npx playwright codegen --save-storage=auth.json https://app.example.com`),
then pass `storage_state_path: "auth.json"` to `studio_start`.

## Keeping junk off the tape

- **Cookie banner?** Pass your consent cookie via `cookies` so it never mounts.
- **Chat bubble / dev overlay?** List selectors in `hide_selectors` — hidden from frame 1.
- **Wrong flash color on page loads?** Set `theme.bg` to your app's real background.

## Why it looks good (the hard-won part)

No white flash on page commits (the theme background paints before any page CSS),
no black frames (navigations hide behind designed title cards, and residual dark
frames are detected and cut deterministically with ffmpeg), no stutter (every
camera move is compositor-friendly easing), and action that reads on camera
(a visible cursor glides to every target before it acts).

## Links

- **Website:** [aioproductos.com](https://aioproductos.com)
- **The product behind it:** [AIOProductOS](https://platform.aioproductos.com) — the product OS that joins feedback, revenue, work, and code on one customer record. Studio is free; it's how our own launch videos get made.
- **Our other MCPs:** [`@aioproductoscom/mcp`](https://www.npmjs.com/package/@aioproductoscom/mcp) (the workspace connector) · [`@aioproductoscom/mcp-agent`](https://www.npmjs.com/package/@aioproductoscom/mcp-agent) (assignable coding teammate)
- **Support:** [office@aioproductos.com](mailto:office@aioproductos.com) — a human founder answers every email.

MIT © AIOProductOS Inc.