---
title: "VisionPiper MCP Server for ToolPiper · ModelPiper"
description: "Drive ToolPiper's screen-vision companion: steer the capture region, grab screenshots, record and export - all on-device. VisionPiper is the ModelPiper companion app for continuous screen work. Federating it into ToolPip"
canonical: "https://modelpiper.com/mcp-tools/visionpiper"
---

# VisionPiper MCP Server for ToolPiper · ModelPiper

> Drive ToolPiper's screen-vision companion: steer the capture region, grab screenshots, record and export - all on-device. VisionPiper is the ModelPiper companion app for continuous screen work. Federating it into ToolPip

V

# VisionPiper MCP Server

✓ verified

Drive ToolPiper's screen-vision companion: steer the capture region, grab screenshots, record and export - all on-device.

Install VisionPiper in ToolPiper

Don't have ToolPiper? We'll take you to the download.

Publisher

[ModelPiper](https://modelpiper.com)

License

Proprietary

Transport

Remote HTTP

Tools

15

## 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 VisionPiper in ToolPiper

Don't have ToolPiper? We'll take you to the download.

## Install in another client

Install in another MCP client (Claude Desktop, Cursor, Continue, Cline)

Claude Desktop Cursor Continue Cline

Add this to ~/Library/Application Support/Claude/claude\_desktop\_config.json.

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

Copy

## Example prompts

-   "Set the VisionPiper region to the top-left quarter of my screen and capture it."
    
    Copy
-   "Start a screen recording, then stop it and export a GIF at half scale."
    
    Copy
-   "What is VisionPiper watching right now?"
    
    Copy

## 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

-   [
    
    F
    
    ### Filesystem
    
    ✓ verified
    
    Read and write files in a directory you choose.
    
    SystemLocal subprocess4 tools
    
    
    
    
    
    ](/mcp-tools/filesystem)
-   [
    
    T
    
    ### Time
    
    ✓ verified
    
    Time and timezone conversion utilities.
    
    SystemLocal subprocess2 tools
    
    
    
    
    
    ](/mcp-tools/time)

[← Back to all MCP tools](/mcp-tools)