Pir MCP server
Motion sensor for AI agents: tells when a screen region changes or goes still. Scores, never pixels.
1 stars126 downloads/wk
Reviews
Write oneNobody has reviewed Pir yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Pir tools (10, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
pir_define_regionName a rectangle of the screen to watch. Coordinates are in the global layout the capture tool uses
pir_define_windowWatch a window rather than a fixed rectangle: geometry is looked up from the window id before
pir_list_regionsThe regions currently defined, with their geometry and masks.
pir_pick_maskAsk the person to draw a rectangle inside an existing region that should be ignored (a clock, a
pir_pick_regionAsk the person at the screen to draw the rectangle to watch (a selector such as slurp appears;
pir_pick_windowAsk the person at the screen to click the window to watch (visible windows are offered as boxes;
pir_remove_regionwrite actionForget a region.
pir_sampleCapture the region once and score it against the previous sample of the same region (null on the
pir_wait_for_changeBlock until the region looks different from how it looked when this call started, or until
pir_wait_for_stillnessBlock until consecutive samples have stayed below threshold for still_for_ms, or until timeout_ms.
Public scan report
scanner v0.1.5 · 2026-09-19 · same rubric, same numbers if you re-run it
- Code scan11 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 3 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Install directly
Runs npx -y pir-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add pir-mcp -- npx -y pir-mcp
Pir: common questions
- Is Pir MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Pir safety report
- How do I install Pir?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Pir need an API key?
- No secret keys are declared. It reads 5 settings from the environment.
- Is Pir maintained?
- The last commit was 4 days ago (2026-09-16). The latest release is v0.1.0.