# pir-mcp

Motion sensor for AI agents: tells when a screen region changes or goes still. Scores, never pixels.

- **Type:** MCP server
- **Trust:** 60/100 (B), scored on the package rubric
- **Verification:** community-indexed — nobody has claimed this listing
- **Version:** 0.1.0
- **Author:** io.github.Solteris-Dev
- **License:** Unknown
- **npm:** pir-mcp
- **Source:** https://github.com/Solteris-Dev/pir-mcp
- **Compatible clients:** claude-code, cursor, copilot, gemini (basis: transport)

## Trust

60/100 (B), scored on the package rubric
- Publisher verified: no
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 18 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-09-17T18:10:16.670Z
- **Version scanned:** 0.1.0
- **CVEs:** none found by OSV at scan time

## Tools

10 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `pir_define_region` — Name a rectangle of the screen to watch. Coordinates are in the global layout the capture tool uses
- `pir_define_window` — Watch a window rather than a fixed rectangle: geometry is looked up from the window id before
- `pir_pick_window` — Ask the person at the screen to click the window to watch (visible windows are offered as boxes;
- `pir_pick_region` — Ask the person at the screen to draw the rectangle to watch (a selector such as slurp appears;
- `pir_pick_mask` — Ask the person to draw a rectangle inside an existing region that should be ignored (a clock, a
- `pir_list_regions` — The regions currently defined, with their geometry and masks.
- `pir_remove_region` — Forget a region.
- `pir_sample` — Capture the region once and score it against the previous sample of the same region (null on the
- `pir_wait_for_change` — Block until the region looks different from how it looked when this call started, or until
- `pir_wait_for_stillness` — Block until consecutive samples have stayed below threshold for still_for_ms, or until timeout_ms.

## Install

**Verdict: review** — Installable, but 1 thing to check first: No publisher has proved control of this listing; it is indexed, not vouched for.
**Cautions** (coverage gaps and advisories — never blocking)
- No publisher has proved control of this listing; it is indexed, not vouched for.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"pir\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"pir-mcp\"\n      ]\n    }\n  }\n}"
```

## Blast radius

Extensive blast radius — deletes data; runs on your machine.
- Floor 35, ceiling 59 (tier: extensive)
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/pir-mcp
- Install plan: https://forgeregistry.com/api/v1/packages/pir-mcp/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/pir-mcp
- HTML page: https://forgeregistry.com/registry/pir-mcp
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.