screenshot
Capture screenshots of iOS Simulator displays by specifying the output path, image format, and display type. Supports various image formats and handles non-rectangular displays with mask options.
Instructions
Takes a screenshot of the iOS Simulator
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| display | No | Display to capture (internal or external). Default depends on device type. | |
| mask | No | For non-rectangular displays, handle the mask by policy (ignored, alpha, or black) | |
| output_path | Yes | File path where the screenshot will be saved. If relative, it uses the directory specified by the `IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR` env var, or `~/Downloads` if not set. | |
| type | No | Image format (png, tiff, bmp, gif, or jpeg). Default is png. | |
| udid | No | Udid of target, can also be set with the IDB_UDID env var |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"display": {
"description": "Display to capture (internal or external). Default depends on device type.",
"enum": [
"internal",
"external"
],
"type": "string"
},
"mask": {
"description": "For non-rectangular displays, handle the mask by policy (ignored, alpha, or black)",
"enum": [
"ignored",
"alpha",
"black"
],
"type": "string"
},
"output_path": {
"description": "File path where the screenshot will be saved. If relative, it uses the directory specified by the `IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR` env var, or `~/Downloads` if not set.",
"maxLength": 1024,
"type": "string"
},
"type": {
"description": "Image format (png, tiff, bmp, gif, or jpeg). Default is png.",
"enum": [
"png",
"tiff",
"bmp",
"gif",
"jpeg"
],
"type": "string"
},
"udid": {
"description": "Udid of target, can also be set with the IDB_UDID env var",
"pattern": "^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
"type": "string"
}
},
"required": [
"output_path"
],
"type": "object"
}