mcp-screen mcp

v1.0.0 · MCP Tool · system · registry.pascalai.org

Capture the Windows desktop (full screen or a specific area) and save as PNG, JPEG or BMP. Returns screen info, virtual bounds and monitor count.

screenscreenshotcapturedesktopwindowsimagepng

Input Parameters

ParameterTypeDescription
operationrequired string info: return screen dimensions and monitor count. capture: save full virtual screen to file. capture_area: save a rectangular region to file. One of: info, capture, capture_area.
outputPathoptional string Destination file path. Extension determines format: .png (default, lossless), .jpg (lossy), .bmp (uncompressed). Required for capture and capture_area.
xoptional integer Left edge of capture area in pixels (from primary screen origin). Required for capture_area.
yoptional integer Top edge of capture area in pixels. Required for capture_area.
widthoptional integer Width of capture area in pixels. Required for capture_area.
heightoptional integer Height of capture area in pixels. Required for capture_area.

Output Fields

FieldTypeDescription
primary_width integer
primary_height integer
virtual_left integer
virtual_top integer
virtual_width integer
virtual_height integer
monitor_count integer
output string
width integer
height integer
size_bytes integer

Examples

Get screen info

// Input
{
  "operation": "info"
}

// Output
{
  "primary_width": 1920,
  "primary_height": 1080,
  "monitor_count": 2
}

Capture full desktop

// Input
{
  "operation": "capture",
  "outputPath": "C:/screenshots/desktop.png"
}

// Output
{
  "output": "C:/screenshots/desktop.png",
  "width": 3840,
  "height": 1080,
  "size_bytes": 1048576
}

Capture a region

// Input
{
  "operation": "capture_area",
  "outputPath": "C:/screenshots/area.png",
  "x": 0,
  "y": 0,
  "width": 800,
  "height": 600
}

// Output
{
  "output": "C:/screenshots/area.png",
  "width": 800,
  "height": 600,
  "size_bytes": 204800
}

Install & Discovery

Install

ppm install mcp-screen

Get JSON Schema

GET /v1/packages/mcp-screen/1.0.0/schema

Discover by keyword

GET /v1/mcp/discover?q=screen
Discovery hint: Install with ppm install mcp-screen or invoke remotely via POST /v1/invoke/mcp-screen on the MCP Service.

PascalAI Usage

uses toolslib;
var Tool := LoadTool('mcp-screen');
var R := Tool.Call(JsonObj(['operation','capture','outputPath','C:/screen.png']));
Writeln(R.ToJSON);