io.github.mcpware/pagecast
Record any browser page as GIF or video via MCP
Ask AI about io.github.mcpware/pagecast
Powered by Claude Β· Grounded in docs
I know everything about io.github.mcpware/pagecast. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Pagecast
English | 廣ζ±θ©±
Turn AI browser interactions into polished product demos.
Tell your AI to demo your app. Pagecast records the browser, tracks every click and keystroke, and exports a shipping-ready GIF or MP4 β with tooltip zoom overlays and cinematic pan effects. No screen recorder. No video editor. No post-production. Make a demo gif automatically after every PR if you want.
Without Pagecast β plain screen recording, you do the demonstration yourself and record yourself and you need to repead every time you changed the UI. You can see the cursor moving, but the actual interactions are too small to follow:

With Pagecast (tooltip mode) β a magnified close-up appears on every interaction so viewers can actually see what's happening, and it design what to demo and make a new demo gif automatically:

With Pagecast (cinematic mode) β the camera crops and pans to follow each action, and it design what to demo and make a new demo gif automatically:

Two ways to use Pagecast
1. Product demo tool (the main use case)
You built a web app. You need a demo GIF for the README. Normally you'd:
- Open a screen recorder, manually click through the demo
- Open a video editor, zoom into the important parts
- Export, figure out ffmpeg, optimize the file size
- UI changes β repeat everything
With Pagecast, you tell your AI:
"Record a demo of localhost:3000 for my GitHub README"
The AI opens a real browser, interacts with your app, and exports a polished GIF with auto-zoom on every interaction. UI changes? Just re-run. The demo rebuilds itself.
2. Screen recording tool (also works)
Don't need zoom effects? Pagecast works as a plain screen recorder too:
"Record my app for 10 seconds and export as MP4"
The AI records, you get a .webm β optimized .gif or .mp4. Two-pass ffmpeg palette optimization, platform-aware sizing, one tool call.
Export Modes
| Mode | Tool | What it does | Best for |
|---|---|---|---|
| Tooltip | smart_export | Full viewport visible + magnified tooltip inset near each interaction | README demos, product pages |
| Cinematic | cinematic_export | Camera crops and pans to follow each interaction | Social media, dramatic reveals |
| Plain | convert_to_gif / convert_to_mp4 | Standard screen recording, no zoom effects | Bug reports, QA captures |
Just Say Where It's Going
You don't need to know viewport sizes or formats. Just tell your AI the destination:
"Record a demo for GitHub README" β 1280Γ720 GIF
"Record my app for Instagram Reels" β 1080Γ1920 MP4
"Make a TikTok demo of my dashboard" β 1080Γ1920 MP4
"Record for YouTube" β 1280Γ720 MP4
| Platform | Size | Format | Aspect |
|---|---|---|---|
github / readme | 1280Γ720 | GIF | 16:9 |
youtube / twitter | 1280Γ720 | MP4 | 16:9 |
reels / tiktok / shorts | 1080Γ1920 | MP4 | 9:16 |
instagram / linkedin | 1080Γ1080 | MP4 | 1:1 |
| Custom | Any size | Your choice | Any |
Quick Start
Node.js β₯ 20 and ffmpeg required.
# Add to Claude Code
claude mcp add pagecast -- npx -y @mcpware/pagecast
# Or run directly
npx @mcpware/pagecast
# Headless mode (no visible browser)
claude mcp add pagecast -- npx -y @mcpware/pagecast --headless
# First time: install browser
npx playwright install chromium
How It Works
You: "Record a demo of my app"
β
AI β record_page(url, platform: "github")
Opens Chromium (visible) at 1280Γ720
Injects cursor highlight + click ripple
β
AI β interact_page(click, type, hover...)
Each action records bounding box + timestamp
β
AI β stop_recording
Saves .webm + timeline.json
β
AI β smart_export (tooltip mode)
or cinematic_export (crop-pan mode)
or convert_to_gif (plain mode)
β
Shipping-ready .gif or .mp4
What makes the demo look professional:
- Cursor highlight β red dot tracks the mouse so viewers can follow the action
- Click ripple β visual feedback on every click
- Tooltip overlay β magnified close-up appears near each interaction, with a small arrow pointing toward it
- Cinematic pan β smooth crop transitions between interaction targets with easeInOut curves
MCP Tools
| Tool | What it does |
|---|---|
record_page | Open a URL, start recording. Auto-injects cursor highlight + click ripple |
interact_page | scroll, click, hover, type, press keys, select, navigate, waitForSelector β all captured with bounding boxes |
stop_recording | Stop and save .webm + -timeline.json (event timeline with interaction positions) |
smart_export | Tooltip overlay β magnified tooltip close-up on each interaction |
cinematic_export | Cinematic crop-pan β camera follows the action between interaction targets |
convert_to_gif | WebM β optimized GIF (ffmpeg two-pass palette, configurable FPS/width/trim) |
convert_to_mp4 | WebM β MP4 (H.264, ready for social/sharing/embedding) |
record_and_export | All-in-one: record β auto-export to GIF or MP4 based on platform |
list_recordings | List all .webm, .gif, and .mp4 files in output directory |
Comparison
| Automated | Interactions | Demo zoom | Output | AI-driven | Platform presets | |
|---|---|---|---|---|---|---|
| Pagecast | β | β click/type/scroll/hover | β tooltip + cinematic | GIF + WebM + MP4 | β | β |
| Screen Studio | β manual | β | β cursor-based | MP4 | β | β |
| AutoZoom | β manual | β | β click-based | MP4 | β | β |
| Playwright MCP | β | β | β | Raw .webm | Partial | β |
| gifcap.dev / Peek / Kap | β manual | β | β | GIF | β | β |
| VHS (Charmbracelet) | β scripted | Terminal only | β | GIF | β | β |
Screen Studio and AutoZoom have great zoom β but require manual recording. Pagecast is the only tool where the AI records AND the demo effects are automatic.
Configuration
| Setting | Default | Notes |
|---|---|---|
| Browser | Headed (visible) | --headless for background |
| GIF FPS | 12 | Higher = smoother, larger |
| GIF width | 800px | Height auto-scaled |
| Tooltip magnify | 1.6x | How much the tooltip zooms in |
| Tooltip size | 380px | Size of the tooltip inset |
| Cinematic zoom | 2.5x | How much the camera zooms in |
| Zoom transition | 0.35s | Smoothstep ease-in/out duration |
| Cursor overlay | On | Red dot + click ripple effect |
| Video viewport | 1280Γ720 | Or use platform parameter |
| Output dir | ./recordings | Override: RECORDING_OUTPUT_DIR |
Architecture
src/
βββ index.js # MCP server β 9 tools, platform presets, stdio transport
βββ recorder.js # Playwright browser lifecycle + sessions + event timeline
βββ converter.js # ffmpeg GIF/MP4 + tooltip overlay + cinematic zoom conversion
βββ zoom.js # Zoom engine β chains, panning, tooltip events, FFmpeg expressions
βββ tooltip.js # Tooltip PNG generator (rounded rect + arrow, pure Node.js)
βββ remotion/
βββ ZoomComposition.jsx # React composition for cinematic zoom
βββ Root.jsx # Remotion entry point
βββ render.js # Remotion CLI wrapper
- Event timeline β every interaction records bounding box + timestamp
- Cursor overlay β red dot + click ripple injected into the page
- Tooltip overlay β magnified close-up in a clean tooltip frame with directional arrow
- Cinematic zoom chains β nearby interactions form chains that zoom in, pan, zoom out
- Thread-safe FFmpeg expressions β crop filters work correctly with multi-threaded encoding
- Headed by default β watch what the AI does
execFilenotexecβ safe against shell injection
More from @mcpware
| Project | What it does | Install |
|---|---|---|
| Instagram MCP | 23 Instagram Graph API tools β posts, comments, DMs, stories, analytics | npx @mcpware/instagram-mcp |
| Claude Code Organizer | Visual dashboard for Claude Code memories, skills, MCP servers, hooks | npx @mcpware/claude-code-organizer |
| UI Annotator | Hover labels on any web page β AI references elements by name | npx @mcpware/ui-annotator |
| LogoLoom | AI logo design β SVG β full brand kit export | npx @mcpware/logoloom |
License
MIT
