# Ctrlpi Pi Bay MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.ctrlpi%2Fpi-bay
Registry id: `mcp-registry/io.github.ctrlpi/pi-bay`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "ctrlpi-pi-bay-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ctrlpi/pi-bay"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add ctrlpi-pi-bay-mcp-server -- npx -y @ctrlpi/pi-bay
```

## Tools (12)

- `pi_command_run`: Run a shell command and return its output and exit code, with a timeout.
- `pi_ctrlpi_install`: Install or update the ctrlPi API and start its service when sudo needs no password.
- `pi_device_authenticate`: Sign in over SSH and optionally save the password to the system keychain.
- `pi_device_info`: Get hardware model, OS, kernel, storage, memory, uptime, and ctrlPi details.
- `pi_device_reboot`: Reboot the device.
- `pi_devices_list`: List discovered devices on the LAN with model, ctrlPi status, and saved credential availability.
- `pi_directory_create`: Create a folder relative to $HOME.
- `pi_file_read`: Read a file as UTF-8 text or base64.
- `pi_file_write`: Create or overwrite a UTF-8 or base64 file, up to 16 MB, creating missing parent folders.
- `pi_files_list`: List one folder relative to $HOME, optionally with hidden files.
- `pi_path_delete`: Permanently delete a file or recursively delete a folder relative to $HOME.
- `pi_path_rename`: Rename or move a file or folder relative to $HOME.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
