For AI agents

Drive Wispframe from your agent.

Plug Wispframe into Claude, Cursor, or any MCP-compatible agent and ask for recordings in plain language — "record display 1 for 10 seconds", "remove the background of clip.mp4". Nothing to install: the running Wispframe app is the MCP server — copy the config from its ⌘ CLI & MCP panel.

1

Open the app

There is nothing to install: the running Wispframe app IS the MCP server. Click ⌘ CLI & MCP in the app header and copy the config it shows — it has your live port and token filled in.

No npm, no Node, no separate process. The app holds the screen/camera permissions, so your agent needs none — and every capture asks you for approval inside the app first.

2

Add to your agent

Pick your agent (top-right), then drop this in:

Claude Code — add it in one line (paste your token from the app)
claude mcp add --transport http wispframe http://127.0.0.1:8763/mcp \
  --header "Authorization: Bearer <token from the app>"
…or by hand in .mcp.json / claude_desktop_config.json
{
  "mcpServers": {
    "wispframe": {
      "type": "http",
      "url": "http://127.0.0.1:8763/mcp",
      "headers": { "Authorization": "Bearer <token from the app>" }
    }
  }
}
3

Just ask

Restart the agent, then talk to it:

“Record display 1 for 10 seconds.”

“Take a full-screen screenshot.”

“Remove the background of cam.mp4.”

“Turn demo.mp4 into a GIF.”

What your agent can do

Every tool runs on the same zero-copy pipeline and returns the output file path back to the agent.

list_sources

Enumerate displays, windows & apps

list_cameras

Enumerate cameras (incl. iPhone)

record_screen

Record a display / window / app to MP4

record_camera

Camera alone — webcam, USB or iPhone

screenshot

Full / window / region PNG

scroll_capture

Stitch a long page into one PNG

pick_color

Sample a pixel's HEX

remove_background

Green-screen a clip, on-device

compose

Overlay PiP, redact/blur faces, burn-in text

compose_grid

Combine 2–9 videos — layouts, keyframes, shapes

run_settings

Execute a saved app session (settings JSON)

studio

Framed backdrop, rounded corners, shadow

trim

Keep / cut time ranges

speed

Global or per-segment speed

to_gif

Clip → animated GIF

annotate_video

Arrows, boxes, text, blur — timed

subtitle_transcribe

On-device Whisper → word-timed JSON

subtitle_burn

Burn styled captions (22 presets)

subtitle_export

Convert captions to SRT / VTT

enhance

2×/4× on-device super-resolution

burn_timer

Elapsed-time clock burned into a video

annotate_image

Arrows, boxes, text on a still PNG

Every tool runs inside the Wispframe app, which already holds the Screen Recording permission — there is no separate process and nothing leaves your Mac. These tools cover the common jobs; anything beyond them (keyframed layouts, multi-display capture, live grids) is available through the CLI. See the CLI reference for the full command surface.