
Pi Bay
App and MCP server for Raspberry Pis and SSH devices on a LAN: files, terminal, ctrlPi API install.
- GitHub stars
- 1
- tools
- 12
- transport
- STDIO
- last updated
- Nov 8, 2026
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
pi_devices_listList discovered devices on the LAN with model, ctrlPi status, and saved credential availability.
List discovered devices on the LAN with model, ctrlPi status, and saved credential availability.
No parameter schema in public metadata yet.
pi_device_infoGet hardware model, OS, kernel, storage, memory, uptime, and ctrlPi details.
Get hardware model, OS, kernel, storage, memory, uptime, and ctrlPi details.
No parameter schema in public metadata yet.
pi_device_authenticateSign in over SSH and optionally save the password to the system keychain.
Sign in over SSH and optionally save the password to the system keychain.
No parameter schema in public metadata yet.
pi_command_runRun a shell command and return its output and exit code, with a timeout (default 30 s, max 5 min).
Run a shell command and return its output and exit code, with a timeout (default 30 s, max 5 min).
No parameter schema in public metadata yet.
pi_files_listList one folder relative to $HOME, optionally with hidden files.
List one folder relative to $HOME, optionally with hidden files.
No parameter schema in public metadata yet.
pi_file_readRead a file as UTF-8 text or base64.
Read a file as UTF-8 text or base64.
No parameter schema in public metadata yet.
pi_file_writeCreate or overwrite a UTF-8 or base64 file, up to 16 MB, creating missing parent folders.
Create or overwrite a UTF-8 or base64 file, up to 16 MB, creating missing parent folders.
No parameter schema in public metadata yet.
pi_directory_createCreate a folder relative to $HOME.
Create a folder relative to $HOME.
No parameter schema in public metadata yet.
pi_path_renameRename or move a file or folder relative to $HOME.
Rename or move a file or folder relative to $HOME.
No parameter schema in public metadata yet.
pi_path_deletePermanently delete a file or recursively delete a folder relative to $HOME.
Permanently delete a file or recursively delete a folder relative to $HOME.
No parameter schema in public metadata yet.
pi_device_rebootReboot the device.
Reboot the device.
No parameter schema in public metadata yet.
pi_ctrlpi_installInstall or update the ctrlPi API (pi-gpio-api), and start its service when sudo needs no password.
Install or update the ctrlPi API (pi-gpio-api), and start its service when sudo needs no password.
No parameter schema in public metadata yet.
Sponsors
Readme
Pi Bay
pi-bay is an App and MCP Server for managing Raspberry Pis and other SSH devices on a LAN: find them, browse and edit their files, and run commands in an SSH terminal.
Quick start
Requires Node.js 20 or newer and SSH enabled on the target device.
npx @ctrlpi/pi-bay
Details
- Repository
- github.com/ctrlpi/pi-bay
- Category
- Developer Tools
- Package
@ctrlpi/pi-bay- Transport
- STDIO
- Registry
- MCP registry, active