{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-21T23:12:24.475Z","url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp","markdownUrl":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp.md","server":{"slug":"ctrlpi-ctrlpi-mcp","name":"io.github.ctrlpi/ctrlpi-mcp","registryName":"io.github.ctrlpi/ctrlpi-mcp","description":"MCP server to control Raspberry Pi, Pico W and ESP32 GPIO agents from an AI assistant.","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"ctrlpi-mcp","type":"npm","identifier":"ctrlpi-mcp","withdrawn":false,"url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp","version":"0.9.41","transport":"stdio","scoredAt":"2026-11-21T05:53:13.496Z"},"score":{"total":68,"tier":"medium","status":"scored","weekDelta":null,"history":[{"date":"2026-11-21","total":68},{"date":"2026-11-20","total":68},{"date":"2026-11-19","total":67},{"date":"2026-11-18","total":52},{"date":"2026-11-17","total":51}]},"categories":[{"name":"Supply Chain Security","score":100,"verdict":"pass","reasons":["No malware found by supply-chain analysis.","No known CVEs affecting this package version or its production dependencies.","No install/post-install scripts declared.","No production dependencies, so there is no dependency health to assess."],"codes":[{"code":"supplychain.malware_clean","args":{}},{"code":"cve.none","args":{}},{"code":"installscript.none","args":{}},{"code":"dephealth.no_dependencies","args":{"deps":"0","unhealthy":"0"}}]},{"name":"Provenance & Transparency","score":45,"verdict":"fail","reasons":["Source repository is publicly reachable at the declared URL.","Provenance check failed: no build-provenance attestation is published.","Clear OSI-approved license (MIT).","Actively maintained (last published 2 days ago).","Disclosure check failed: no security disclosure policy was found in the source repository."],"codes":[{"code":"provenance.repo_verified","args":{}},{"code":"provenance.none","args":{}},{"code":"license.osi","args":{"spdx":"MIT"}},{"code":"maintenance.recent","args":{"age_days":"2"}},{"code":"disclosure.absent","args":{}}]},{"name":"Schema Quality & AI Usability","score":67,"verdict":"fail","reasons":["AI-judged instruction clarity (good).","Tool/resource definitions use about 1878 tokens (~104/item across 18 items; 18 tools + 0 resources), lean.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.ai_quality","args":{"band":"good"}},{"code":"schema.footprint_lean","args":{"avg":"104","items":"18","tools":"18","tokens":"1878","resources":"0"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":13,"verdict":"partial","reasons":["Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses."],"codes":[{"code":"stability.building_history","args":{"days":"4"}}]},{"name":"Tool Coverage","score":67,"verdict":"fail","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","0% of tool parameters carry a description."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"0"}}]},{"name":"Tool Safety","score":100,"verdict":"pass","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","We read all 18 captured tool definition(s), and no name or description among them implies an irreversible operation.","An AI judge read all 18 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_none","args":{"tools":"18"}},{"code":"toolsafety.manipulation_clean","args":{"units":"18","judged":"18"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28."],"codes":[{"code":"protocol.supported","args":{"latest":"2026-07-28","version":"2025-11-25"}}]}],"inconclusive":[],"malware":[],"components":[{"slug":"ctrlpi-mcp","type":"npm","identifier":"ctrlpi-mcp","withdrawn":false,"score":68,"current":true,"url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp","markdownUrl":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp.md"}],"facts":[{"label":"Registry","value":"npm"},{"label":"Package","value":"ctrlpi-mcp"},{"label":"Version","value":"0.9.41"},{"label":"Transport","value":"stdio"}],"install":{"available":true,"bundleSha256":null},"tools":[{"name":"mcp_agents_list","title":"List agents","description":"List configured agents (Pi, Pico or ESP32). Returns name, ip, port, online (live /hello probe), type (pi/pico/esp32), version, has_default_key, and last_updated_at (UTC \"YYYY-MM-DD HH:MM:SS\", when the agent list was last saved; every sweep saves it). Unreachable agents are included (online=false). The LAN is swept automatically every hour. Pass rescan=true to sweep it now, but only when the user asks to find new hardware: a sweep takes 10 seconds or more. If has_default_key is true for any agent, tell the user that agent is on the insecure default key and ask whether to change it.","inputs":[{"name":"rescan","type":"boolean","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":161},{"name":"mcp_gpio_read","title":"Read a pin","description":"Read a GPIO pin value on `agent` by number or name, or 'all' to read all pins.","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"name_or_gpio","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":49},{"name":"mcp_gpio_write","title":"Write a pin","description":"Write a value to a GPIO pin on `agent` ('0', '1', 'on', 'off', or 'toggle'). Optional duration in seconds, after which the pin reverts to its previous state. If the pin has a configured 'max' pulse duration, the effective duration is clamped to it - and if no duration is given but 'max' is set, 'max' is used as the duration automatically.","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"duration","type":"number","required":false,"description":null},{"name":"name_or_gpio","type":"string","required":true,"description":null},{"name":"value","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":127},{"name":"mcp_gpio_scan","title":"Scan all pins","description":"Scan all hardware GPIO pins on `agent` and return each pin's level (the physical state), type, pull resistor and name; a reversed pin also reports `value` (its logical state) and `reversed`. Pins: BCM 2-27 on a Raspberry Pi, GP0-GP28 (minus the WiFi-reserved GP23/24/25/29) on a Pico, and every usable pin of the chip on an ESP32 (flash, PSRAM and USB pins are left out).","inputs":[{"name":"agent","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":122},{"name":"mcp_gpio_config","title":"Configure a pin","description":"Configure a GPIO pin on `agent` by number. type: input/output/vcc/gnd/remove. init: 0/1/last. pullup: up/down/none (input only). max: max pulse duration in seconds (output only). reversed: active-low logic (input/output only). watched: trigger webhook on state change (logged on the agent if no notifications.webhook is configured).","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"gpio","type":"string","required":true,"description":null},{"name":"init","type":"string","required":false,"description":null},{"name":"max","type":"number","required":false,"description":null},{"name":"name","type":"string","required":false,"description":null},{"name":"pullup","type":"string","required":false,"description":null},{"name":"reversed","type":"boolean","required":false,"description":null},{"name":"type","type":"string","required":false,"description":null},{"name":"watched","type":"boolean","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":156},{"name":"mcp_gpio_watched","title":"List watched pins","description":"List the GPIO pins that are currently being actively watched (the ones emitting hardware interrupts/webhooks).","inputs":[{"name":"agent","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":37},{"name":"mcp_sensor_config","title":"Configure a sensor","description":"Configure a named sensor on `agent`. A sensor runs a script and its output is the reading. `script` is \"<script-file> [args...]\": a bare filename in the agent's scripts/ folder (no paths - that folder is the only allowed location), with letters/digits-only arguments. On a Raspberry Pi it is a shell script run with `sh`; on a Pico or ESP32 a .py file the agent execs in-process. Pass remove=true to delete the sensor.","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"name","type":"string","required":true,"description":null},{"name":"remove","type":"boolean","required":false,"description":null},{"name":"script","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":138},{"name":"mcp_sensor_read","title":"Read sensors","description":"Read sensors on `agent`. With no `name`, reads every configured sensor and returns them merged into one JSON object; with a `name`, reads just that sensor. Every reading is nested under its sensor's own name: a script emitting a JSON object with several fields nests whole, one emitting a single-field object contributes just that field's value, and any other output is wrapped the same way.","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"name","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":104},{"name":"mcp_script_list","title":"List scripts","description":"List the files in `agent`'s scripts/ folder (the folder sensors run from): `scripts` ([{name, size, modified}]) and `write`: \"enabled\", \"default_key\" (writes are refused until the agent's api_key is changed from the default) or \"locked\" (a write.lock file there blocks every write).","inputs":[{"name":"agent","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":89},{"name":"mcp_script_read","title":"Read a script","description":"Read one file from `agent`'s scripts/ folder. Returns {name, content}.","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"name","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":43},{"name":"mcp_script_write","title":"Write or delete a script","description":"Create or overwrite a file in `agent`'s scripts/ folder with `content`, or delete it with remove=true. `name` is a bare filename of up to 32 characters (letters, digits, . _ -, no leading dot or dash, no paths). Refused while the agent still has the default api_key, and once a write.lock file is in the folder. Writing write.lock (any content) locks every script write, and this tool can then no longer change or remove it. The lock does not stop runs: a script run with mcp_script_run that deletes files can remove write.lock, as can a shell (Pi) or USB (Pico, ESP32).","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"content","type":"string","required":false,"description":null},{"name":"name","type":"string","required":true,"description":null},{"name":"remove","type":"boolean","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":179},{"name":"mcp_script_run","title":"Run a script","description":"Run a file from `agent`'s scripts/ folder and return {name, exit_code, output}. On a Raspberry Pi a .py runs with the agent's Python and anything else with `sh`; output is its stdout (first 2 KB) and a run over 15 s is killed. On a Pico or ESP32 the file is exec'd in-process: output is what its read(*args) returns, or its `result`, and exit_code is 1 if it raised. `args` are letters and digits only.","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"args","type":"array","required":false,"description":null},{"name":"name","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":141},{"name":"mcp_config_read","title":"Read agent config","description":"Read `agent`'s global application configuration, grouped: `notifications` (`webhook` + `webhook_key`), `bridges` (matter/homekit/homebridge callbacks), `settings` (docs_enabled, logs_enabled, log_days), `sensors`, and configured pins (`gpios`). The `agent` block (platform, os, ip, cpu_temperature, version) is computed live on every read and is not stored.","inputs":[{"name":"agent","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":107},{"name":"mcp_config_write","title":"Update agent config","description":"Update `agent`'s global configuration dynamically. These are the ungrouped (root) field names; the agent routes each into its group (webhook_url -> notifications.webhook, webhook_key -> notifications.webhook_key, docs_enabled/logs_enabled/log_days -> settings), so a read afterwards shows them nested. log_days controls how long log entries are kept (0-30, clamped; 0 clears the log immediately and keeps only the last hour). docs_enabled is Pi-only. Changing api_key changes the agent's authentication key immediately, and also updates the local agents-config.json file to match automatically.","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"api_key","type":"string","required":false,"description":null},{"name":"docs_enabled","type":"boolean","required":false,"description":null},{"name":"log_days","type":"number","required":false,"description":null},{"name":"logs_enabled","type":"boolean","required":false,"description":null},{"name":"name","type":"string","required":false,"description":null},{"name":"webhook_key","type":"string","required":false,"description":null},{"name":"webhook_url","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":196},{"name":"mcp_config_load","title":"Replace agent config","description":"Load a full config onto `agent` from a dict (the agent saves a backup first). Pass an empty dict {} to reset all settings on the agent keeping only its API key.","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"config","type":"object","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":61},{"name":"mcp_agent_restart","title":"Restart or reboot an agent","description":"Restart `agent`'s server process. Pass reboot=true to reboot the whole device instead (a Pi, Pico or ESP32); an agent running on a Mac ignores it and restarts the process.","inputs":[{"name":"agent","type":"string","required":true,"description":null},{"name":"reboot","type":"boolean","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":65},{"name":"mcp_agent_upgrade","title":"Upgrade an agent","description":"Upgrade `agent` to the latest release, then restart it. A Pi runs `install.sh --upgrade` (re-downloads the release files and reinstalls dependencies); a Pico or ESP32 downloads the new files over WiFi, swaps them in and resets.","inputs":[{"name":"agent","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":70},{"name":"mcp_agent_logs","title":"Read agent log","description":"Read the last 50 lines of `agent`'s server log file.","inputs":[{"name":"agent","type":"string","required":true,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":33}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-21T05:53:13.000Z","track":"package","endpoint":null,"declaredUrl":null,"truncated":false,"tls":null,"dnssec":null,"auth":null,"httpsRedirect":null,"transports":[],"provenance":{"outcome":"none","label":"No attestation","reason":null,"reasonLabel":null,"discovery":null,"discoveryLabel":null,"sourceRepo":null,"attestationSkipped":null,"attestationSkippedLabel":null},"installScripts":[],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":{"nodes":0,"partial":false,"deprecated":null,"stale":null,"noRepo":null}},"mismatches":[],"changelog":{"trackingSince":"2026-11-17","recent":[{"id":"chg_01a1f783-4a72-70f8-8545-876a31318af9","kind":"score.total_changed","summary":"Trust score (67 → 68)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-20","url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp#chg-chg_01a1f783-4a72-70f8-8545-876a31318af9"},{"id":"chg_01a1f25b-8718-7768-8bcc-34248435732e","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp#chg-chg_01a1f25b-8718-7768-8bcc-34248435732e"},{"id":"chg_01a1f25b-8719-7bbd-ad25-94fa7bfb8d5f","kind":"score.total_changed","summary":"Trust score (52 → 67)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp#chg-chg_01a1f25b-8719-7bbd-ad25-94fa7bfb8d5f"},{"id":"chg_01a1eff9-2320-717d-a3a6-921464490d44","kind":"check.reverified","summary":"Stability (unverified → 0.03)","materiality":"functional","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp#chg-chg_01a1eff9-2320-717d-a3a6-921464490d44"},{"id":"chg_01a1eff9-2321-7706-a93d-bc4770e59bd4","kind":"package.version_changed","summary":"Package version (0.9.40 → 0.9.41)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp#chg-chg_01a1eff9-2321-7706-a93d-bc4770e59bd4"},{"id":"chg_01a1eff9-2321-7d71-af90-196876915dc6","kind":"score.total_changed","summary":"Trust score (66 → 52)","materiality":"functional","direction":"regression","scoreDelta":-14,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp#chg-chg_01a1eff9-2321-7d71-af90-196876915dc6"},{"id":"chg_01a1ed30-8995-75c4-bb39-d5ba3d3eaa93","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp#chg-chg_01a1ed30-8995-75c4-bb39-d5ba3d3eaa93"},{"id":"chg_01a1ed30-8999-7579-8ea3-f21fa004a2d7","kind":"score.total_changed","summary":"Trust score (51 → 66)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp#chg-chg_01a1ed30-8999-7579-8ea3-f21fa004a2d7"},{"id":"chg_01a1eb75-39af-7d00-aaa8-9e0f1836da93","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp#chg-chg_01a1eb75-39af-7d00-aaa8-9e0f1836da93"}],"truncated":false,"feedUrl":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp/changelog.json"},"links":{"html":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp","markdown":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp.md","changelogJson":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp/changelog.json","changelogRss":"https://verifymcp.io/servers/ctrlpi-ctrlpi-mcp/ctrlpi-mcp.xml","external":[{"label":"npm package","href":"https://www.npmjs.com/package/ctrlpi-mcp"},{"label":"Socket report","href":"https://socket.dev/npm/package/ctrlpi-mcp"},{"label":"Repository","href":"https://github.com/ctrlpi/ctrlpi-mcp"},{"label":"Website","href":"https://ctrlpi.com/ctrlpi-mcp"}]}}