record
Record a web app headlessly, upload it as a Clipy recording, and return the share link and agent-context URL for immediate sharing and playback.
Instructions
Record a web app HEADLESSLY and upload it as a Clipy recording, then return its share link + agent-context URL. Use this to capture the outcome of work you just did — e.g. after building a feature, record the running app so it can be shared or read back. Opens the given URL in a headless Chromium (works in cloud sandboxes, no display needed), records for durationSeconds, and streams the video into Clipy's pipeline. Set type so the summary reads the recording correctly, viewports to sweep multiple screen sizes into one video, and storageState/initScript/userDataDir to record behind a login. Requires (1) Playwright installed in this MCP server's environment (npm i -g playwright && npx playwright install chromium) and (2) the CLIPY_API_KEY to carry the 'ingest' scope. Recording the REAL Mac screen or a window's initial screen area (ScreenCaptureKit, real logged-in browser) is CLI-only — clipy record --source mac-screen --window "<app>" — and not available via MCP. Quick per-cookie / per-localStorage-key injection (the CLI's --cookie / --local-storage) is a CLI-only convenience; storageState covers the same need here. The result reports the RESOLVED capture source (source: the post-redirect URL, page title and viewport actually being recorded) — compare it against the surface your driver is acting on BEFORE doing minutes of work, because Clipy will never focus or foreground a window or tab for you. Auth note: storageState seeds exactly what it contains (cookies + localStorage) but can't reproduce a whole browser identity (IndexedDB, service workers, some cross-origin auth); for those, produce a storageState via an interactive npx playwright open --save-storage=state.json <login-url> first, or use userDataDir pointed at a DEDICATED (never live) profile directory. After it returns, call wait_for_artifacts then get_agent_context to read the transcript/summary.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The http(s) URL to open and record (e.g. http://localhost:3000). | |
| name | No | Optional title for the recording. | |
| type | No | What the recording IS, so the AI summary doesn't misread it. One of: bug_report, feature_request, product_demo, walkthrough_tutorial, feedback_review, discussion_talk, other (aliases like bug/feature/demo/tutorial/review/talk accepted). | |
| notes | No | Timestamped narration notes describing what the recording shows. Headless captures are silent, so these notes BECOME the recording's transcript — write them like chapters ('0s: homepage loads', '8s: the new export button appears'). | |
| width | No | Viewport + video width (default 1280). Ignored when `viewports` is set. | |
| height | No | Viewport + video height (default 720). Ignored when `viewports` is set. | |
| viewports | No | Record several screen sizes sequentially into ONE video (for cross-size demos). Comma-separated aliases (mobile,tablet,desktop) or WIDTHxHEIGHT (e.g. '390x844,1440x900'). The frame is sized to the largest; each pass slow-scrolls the page and gets an auto chapter note. When set, width/height are ignored. | |
| initScript | No | Path to a JS file run in the page before every navigation (context.addInitScript) — e.g. to seed localStorage or stub an API. Contents are never logged. | |
| description | No | Optional description for the recording. | |
| userDataDir | No | Path to a Chromium user-data ROOT — the dir holding 'Local State' plus profile subdirs (macOS Chrome: ~/Library/Application Support/Google/Chrome). WITHOUT profileDirectory, Clipy opens this dir's 'Default' profile directly and writes to it, so it is refused while a live Chrome holds it locked (quit Chrome first). WITH profileDirectory, Clipy COPIES that named profile into a temporary root and records the copy — your real profile is never opened or modified. A profile SUBDIR passed as the root is refused. Mutually exclusive with storageState. | |
| storageState | No | Path to a Playwright storageState JSON (cookies + localStorage) to record behind a login. Passed unchanged to the browser context; its contents are never logged. Mutually exclusive with userDataDir. | |
| durationSeconds | No | How long to record after the page loads, per viewport pass (default 15, max 300). | |
| profileDirectory | No | Which profile INSIDE userDataDir to record — 'Default', 'Profile 1', 'Profile 2', … (exact folder name from chrome://version → 'Profile Path'). Clipy COPIES that profile into a temporary scratch root (as its Default) and records the copy: your real profile is never opened or modified, and the copy is deleted after upload. The result discloses the copy. Requires userDataDir. (Playwright strips Chromium's --profile-directory, so copying is the only way to select a named profile.) |