ctrlpi avatar

Pico Bay

ctrlpi/pico-bay

App and MCP server for Raspberry Pi Pico and ESP32 boards over USB: files, console, firmware.

GitHub stars
7
tools
13
transport
STDIO
last updated
Nov 8, 2026

Tools

13 tools

Public tool metadata for what this MCP can expose to an agent.

pico_boards_listList connected boards, stable board IDs, firmware details, and capabilities.

List connected boards, stable board IDs, firmware details, and capabilities.

No parameter schema in public metadata yet.

pico_files_listList the board filesystem and report Flash and RAM usage.

List the board filesystem and report Flash and RAM usage.

No parameter schema in public metadata yet.

pico_file_readRead a text or binary file using UTF-8 or base64.

Read a text or binary file using UTF-8 or base64.

No parameter schema in public metadata yet.

pico_file_writeCreate or overwrite a UTF-8 or base64 file, up to 8 MB decoded.

Create or overwrite a UTF-8 or base64 file, up to 8 MB decoded.

No parameter schema in public metadata yet.

pico_directory_createCreate a directory.

Create a directory.

No parameter schema in public metadata yet.

pico_path_renameRename or move a file or directory.

Rename or move a file or directory.

No parameter schema in public metadata yet.

pico_path_deletePermanently delete a file or recursively delete a directory.

Permanently delete a file or recursively delete a directory.

No parameter schema in public metadata yet.

pico_python_runRun a file as __main__ or execute Python code and return its output.

Run a file as __main__ or execute Python code and return its output.

No parameter schema in public metadata yet.

pico_board_interruptSend Ctrl-C to interrupt a running program.

Send Ctrl-C to interrupt a running program.

No parameter schema in public metadata yet.

pico_board_resetSoft-reset a board or request a supported hard reset.

Soft-reset a board or request a supported hard reset.

No parameter schema in public metadata yet.

pico_board_bootloaderPut a board into BOOTSEL or ESP32 download mode for pico_install.

Put a board into BOOTSEL or ESP32 download mode for pico_install.

No parameter schema in public metadata yet.

pico_ctrlpi_installInstall or update the ctrlPi API agent on a Pico W, Pico 2 W, ESP32, ESP32-S3 or ESP32-C3.

Install or update the ctrlPi API agent on a Pico W, Pico 2 W, ESP32, ESP32-S3 or ESP32-C3.

No parameter schema in public metadata yet.

pico_installCheck and install MicroPython on a Pico in BOOTSEL mode or a supported ESP32 in DOWNLOAD mode.

Check and install MicroPython on a Pico in BOOTSEL mode or a supported ESP32 in DOWNLOAD mode.

No parameter schema in public metadata yet.

Sponsors

Readme

Pico Bay

Platform: Cross-Platform Version 0.9.34 Node 20+ Protocol: MCP Tools: 13 License: MIT Status: Beta Build Status

pico-bay is an App and MCP Server for managing Raspberry Pi Pico and ESP32 boards with MicroPython and CircuitPython over USB. It runs with Node.js built-in modules and needs no browser extension or runtime npm dependencies.

Quick start

Requires Node.js 20 or newer.

npx @ctrlpi/pico-bay

View the full README on GitHub

Details

Repository
github.com/ctrlpi/pico-bay
Package
@ctrlpi/pico-bay
Transport
STDIO
Registry
MCP registry, active

More from ctrlpi