Power your agent
The publisher's own command. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code has no install link for a local command. Copy the command below and run it in a terminal.
PIR_CAPTURE_CMD=<value> PIR_SELECT_CMD=<value> PIR_WINDOW_GEOMETRY_CMD=<value> PIR_PICK_WINDOW_CMD=<value> PIR_MAX_WAIT_MS=<value> claude mcp add io.github.solteris-dev-pir-mcp -- npx -y pir-mcp@0.1.0Run in a terminal.
{ "mcpServers": { "io.github.solteris-dev-pir-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "PIR_CAPTURE_CMD": "<value>", "PIR_SELECT_CMD": "<value>", "PIR_WINDOW_GEOMETRY_CMD": "<value>", "PIR_PICK_WINDOW_CMD": "<value>", "PIR_MAX_WAIT_MS": "<value>" } } }}claude_desktop_config.json
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
A motion sensor for AI agents.
"Gives your LLM agents enough info to be a helpful "watcher" without being a privacy nightmare like Windows Recall" -Solteris-Dev
A PIR sensor tells you that something moved, never . This is the same idea for a screen: an MCP server that watches named rectangles and answers "did this change?" and "has this gone still?" with a number, a size and a timestamp. No tool in it returns pixels, image files, or anything that could be turned back into a picture.
Motion sensor for AI agents: tells when a screen region changes or goes still. Scores, never pixels.
It exists because an agent driving a desktop keeps needing the same two things: wake me when the build output moves and tell me if this status bar has stopped ticking. Both are motion questions. Neither needs a screenshot.
pir_pick_region ask the person at the screen to draw the rectangle,
the way a regional screenshot works (slurp, slop). The human chooses what
is sensed; the agent gets the geometry. Use this whenever someone is there.pir_pick_mask the same gesture for a patch inside a region to ignore
(a clock, a spinner, a caret).pir_define_region the scriptable path: name a rectangle by global
layout coordinates, with optional masks.pir_pick_window / pir_define_window watch a window instead of a
fixed rectangle. Its geometry is looked up again before every capture, so
the region follows the window when it moves; a resize counts as maximal
change. The pick offers your visible windows as boxes to click.pir_sample capture once, score against the previous sample of that
region. Cheap; also the way to check the capture command works.pir_wait_for_change block until the region departs from how it looked
when the call began, or time out. A doorbell.pir_wait_for_stillness block until nothing has changed for
still_for_ms, or time out. A short window means "the animation settled,
safe to act". A long window on something that should keep changing means
it is frozen, and still=true is the alarm.pir_list_regions, pir_remove_region housekeeping.Every comparison reports two numbers over a coarse grid of averaged colour cells (at most 64 across, each at least 4 px), both 0 for identical and 1 for black against white:
rmse over the whole grid: did the region as a whole move? A cursor
edge or an antialiased caret scores about 0.02; a dialog opening 0.1 or
more. This is the default metric, threshold 0.05.peak the single most-changed cell: did anything in it move? A clock
digit flipping inside a 1920-wide status bar scores rmse 0.018 (invisible
to the default) but peak 0.145. Use metric=peak for a small thing that
should tick inside a larger region.Averaging is what makes this a sensor rather than a camera: 64 cells cannot be read.
pir_pick_region carries a purpose line
the agent has to write down before you draw.What it does reveal, so you can decide whether that is acceptable: that a given rectangle changed, at a given time, by a given magnitude. On a region covering a chat window that is presence information. Choose regions accordingly; the server has no opinion.
The capture itself is delegated to a command you configure, run with your
privileges. The default is grim, so nothing here has screen access that you
did not already give to grim.
It is on npm as pir-mcp and in
the official MCP Registry
as io.github.Solteris-Dev/pir-mcp, so most clients can run it with
npx -y pir-mcp and no clone:
claude mcp add -s user pir -- npx -y pir-mcp
From source:
git clone https://github.com/Solteris-Dev/pir-mcp
cd pir-mcp && npm install && npm run build
Requires Node 20+ and a screenshot tool that can write binary PPM to stdout.
PIR_CAPTURE_CMD is a template; {x} {y} {w} {h} are substituted and the
result runs under sh -c. It must print a binary PPM (P6) to stdout.
Coordinates are whatever the capture tool uses. On a wlroots layout that is the global layout, so an output placed left of the primary has negative x.
PIR_SELECT_CMD runs when an agent calls pir_pick_region or
pir_pick_mask and must print x,y wxh. Set it to an empty string to remove
those tools entirely.
PIR_WINDOW_GEOMETRY_CMD gets {id} substituted and must print x,y wxh
for that window; PIR_PICK_WINDOW_CMD must print the id of the window the
person chose. Both default to Hyprland (via jq and slurp -r). Set either
to an empty string to remove the corresponding tools. Window ids are limited
to [A-Za-z0-9_.:-] before they reach a shell.
Only the Hyprland pair has been run; the others are written from the tools' documentation.
claude mcp add -s user pir -- npx -y pir-mcp
# or, from a source checkout:
claude mcp add -s user pir -- node /path/to/pir-mcp/dist/stdio.js
Blocking calls default to 55 s and are capped by PIR_MAX_WAIT_MS (540 s).
Keep the cap under your host's MCP tool timeout; an agent that needs to watch
for longer just calls again.
A regions file looks like:
[
{ "name": "bar", "x": 0, "y": 0, "w": 1920, "h": 26,
"masks": [{ "x": 1690, "y": 0, "w": 110, "h": 26 }] }
]
The case that produced this: a status bar that occasionally froze for hours while its process looked healthy. The clock in it should change every minute, so a bar that is still for three minutes is a frozen bar.
pir_pick_region name=bar purpose="watch the status bar for a freeze"
pir_wait_for_stillness name=bar still_for_ms=180000 metric=peak timeout_ms=540000
still=true comes back only if the bar stopped; otherwise the call returns
still=false at the timeout and the agent calls again. Nothing on the screen
was ever seen, and the person drew the rectangle themselves.
contrib/macos/ holds an AppKit rectangle selector and capture recipe,
written blind and untested. If you run it on a real Mac, fix what breaks and
send it back.
npm test
MIT.
© 2026 MCP Directory.
Motion sensor for AI agents: tells when a screen region changes or goes still. Scores, never pixels.
{ "mcpServers": { "io.github.solteris-dev-pir-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "PIR_CAPTURE_CMD": "<value>", "PIR_SELECT_CMD": "<value>", "PIR_WINDOW_GEOMETRY_CMD": "<value>", "PIR_PICK_WINDOW_CMD": "<value>", "PIR_MAX_WAIT_MS": "<value>" } } }}Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
The publisher lists these environment variables: PIR_CAPTURE_CMD, PIR_SELECT_CMD, PIR_WINDOW_GEOMETRY_CMD, PIR_PICK_WINDOW_CMD, PIR_MAX_WAIT_MS.
Pir runs locally over stdio.
Last checked 2026-11-09. Motion sensor for AI agents: tells when a screen region changes or goes still. Scores, never pixels.