VisionPiper MCP Server

What this server does

VisionPiper is the ModelPiper companion app for continuous screen work. Federating it into ToolPiper lets any agent steer the capture region, take screenshots, and manage recordings over MCP, while the hardware-accelerated frame stream stays on its own data plane. Requires VisionPiper running locally on port 9999.

Tools included

• get_status

  Current capture region, display, and streaming state.

• select_region

  Open the interactive region-selection overlay.

• set_region

  Set the capture region programmatically (agent steering).

• capture

  Capture the current region; autosaves and returns the file path.

• capture_if_changed

  Capture only if the region content changed since the last capture.

• preview

  Small inline preview image of the current region.

• get_last_image

  Path of the most recent capture.

• record_start

  Start recording the region (optional region override).

• record_stop

  Stop recording; returns the saved mp4 path.

• recording_status

  idle / recording / converting.

• list_recordings

  Paths of saved recordings.

• export_gif

  Export the last recording as GIF (scale/fps options).

• export_webp

  Export the last recording as animated WebP (scale/fps options).

• cancel_convert

  Cancel an in-flight GIF/WebP conversion.

• stream_status

  Frame-stream port, client count, and fps.

The authoritative list comes from the server's tools/list at runtime. This catalog entry may lag the upstream until the next ToolPiper release.

Install in ToolPiper

ToolPiper handles the JSON configuration. Click Install, fill in any required tokens, and the server is ready in your chat.

Install in another client

{
  "mcpServers": {
    "visionpiper": {
      "url": "http://127.0.0.1:9999/mcp"
    }
  }
}

Example prompts

Security notes

Runs entirely on-device over loopback HTTP. Screen access is gated by macOS Screen Recording permission (TCC) plus the always-visible region overlay. Capture and recording tools default to Ask; only the read-only status tools are pre-allowed.

Related tools