Capture a full screenshot of any display or a precise pixel region, saved as a timestamped PNG to a folder of your choice.
The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.
Jump to:
list_displayscapture_screencapture_region
list_displays
List the available displays with their index, position and size, so you know what to pass as 'display' to capture_screen.
This action takes no inputs.
| Name | Type | Notes |
|---|---|---|
displays |
json |
capture_screen
Capture a whole display and save it as a PNG. display 0 captures every display combined (the full virtual desktop); 1, 2, ... capture one physical display (see list_displays).
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
out |
path |
optional, default ""
|
|
display |
int |
optional, default 0
|
|
prefix |
string |
optional, default screenshot
|
| Name | Type | Notes |
|---|---|---|
file |
path | |
width |
int | |
height |
int |
capture_region
Capture a rectangular pixel region of the desktop (x, y, width, height, in absolute desktop coordinates) and save it as a PNG.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
x |
int | required | |
y |
int | required | |
w |
int | required | |
h |
int | required | |
out |
path |
optional, default ""
|
|
prefix |
string |
optional, default screenshot
|
| Name | Type | Notes |
|---|---|---|
file |
path | |
width |
int | |
height |
int |
python app.py --action list_displays --params '{}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("screenshotter", "list_displays", {}){
"id": "n0",
"app": "screenshotter",
"action": "list_displays",
"params": {},
"inputs": {}
}python app.py --action capture_screen --params '{}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("screenshotter", "capture_screen", {}){
"id": "n0",
"app": "screenshotter",
"action": "capture_screen",
"params": {},
"inputs": {}
}python app.py --action capture_region --params '{"x": 1, "y": 1, "w": 1, "h": 1}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("screenshotter", "capture_region", {"x": 1, "y": 1, "w": 1, "h": 1}){
"id": "n0",
"app": "screenshotter",
"action": "capture_region",
"params": {
"x": 1,
"y": 1,
"w": 1,
"h": 1
},
"inputs": {}
}Things you can say to Claude, Cursor or Codex once the MCP server is registered.