SkillAgentSearch skills...

pico-bay

App and MCP Server for managing Raspberry Pi Pico and ESP32 boards with MicroPython or CircuitPython over USB.

Install / Use

claude mcp add ctrlpi -- npx -y github:ctrlpi/pico-bay

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

81/100

Supported Platforms

Claude Code
Claude Desktop

Our assessment of pico-bay

pico-bay scores 81/100 on our quality scale, 3437th of 4,698 Development & Engineering skills we index.

Its MCP Server is 21 KB long, well organised into 28 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
12/15
Adoption
4/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so pico-bay is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-13. Automated pattern scan on 2026-11-13. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

pico-bay compared with similar skills

All 4 of these similar skills score higher than pico-bay; compare them before choosing.

SkillScoreStarsUpdatedFormat
pico-bay (this skill)by ctrlpi8110todayMCP Server
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install pico-bay?
Run claude mcp add ctrlpi -- npx -y github:ctrlpi/pico-bay. The install tabs above show the steps for each supported agent.
Which AI agents does pico-bay work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is pico-bay safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is pico-bay still maintained?
The repository was last updated today, so pico-bay is actively maintained.

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

Your browser will open automatically! If it doesn't, head to http://localhost:7426. On a Raspberry Pi, open http://PI_HOST_ADDR:7426 from another device on the same network, replacing PI_HOST_ADDR with the Pi's IP address or hostname.

Port 7426 spells PICO on a phone keypad, a nod to the T9 years and flip-phone era.

Devices

  • Supports Raspberry Pi Pico and ESP32 boards with MicroPython or CircuitPython, including Pico, Pico W, Pico 2, Pico 2 W, ESP32, ESP32-S2, ESP32-C3, and ESP32-S3.
  • Detects multiple connected boards and follows USB hot-plug events.
  • Detects MicroPython or CircuitPython automatically, including whether its filesystem is read-only or writable.
  • Detects RP2040 and RP2350 BOOTSEL mode and installs the latest MicroPython firmware for the selected Pico model.
  • Detects Espressif ROM download mode over USB serial, shows the detected chip details, and installs the latest generic MicroPython firmware on supported ESP32 chips.
  • Shows Flash and RAM usage for each board.
  • Supports soft reset, hard reset, Ctrl-C interruption, and filesystem cleanup.

Files

  • Browses the complete filesystem as a searchable, collapsible tree.
  • Shows file sizes and modification times when the board provides them.
  • Creates, renames, moves, uploads, downloads, and recursively deletes files and folders.
  • Opens text files with Python and JSON highlighting.
  • Renders a safe Markdown preview without executing embedded HTML.
  • Detects binary files and offers them for download instead of displaying them as text.
  • Downloads and restores the complete filesystem as a standard ZIP archive.

Run and console

  • Runs any Python file as __main__ without replacing main.py.
  • Streams program and boot output to a live console.
  • Accepts console input and can interrupt a running program with Ctrl-C.

MCP server

pico-bay includes a dependency-free Model Context Protocol server, enabled by default on Raspberry Pi hosts. On macOS and other non-Pi hosts, enable MCP in the user interface or with --mcp-stdio or --mcp-http.

Agent configuration

In Claude Desktop, open Settings → Developer → Edit Config to get to the configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or the equivalent file on Windows or Linux), and add the server under mcpServers enabling stdio:

{
  "mcpServers": {
    "pico-bay": {
      "command": "npx",
      "args": ["-y", "@ctrlpi/pico-bay", "--mcp-stdio"]
    }
  }
}

Cursor takes the same JSON, here and under Streamable HTTP. Put it in ~/.cursor/mcp.json, or in .cursor/mcp.json inside a project.

Streamable HTTP

Use HTTP when the MCP client runs on another computer or Raspberry Pi:

npx @ctrlpi/pico-bay --mcp-http

The normal web interface remains available and MCP is served at http://HOST:7426/mcp. Configure the MCP agent to connect over HTTP, replacing PI_HOST_ADDR with the platform running pico-bay:

{
  "mcpServers": {
    "pico-bay": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://PI_HOST_ADDR:7426/mcp", "--allow-http"]
    }
  }
}

--allow-http permits the connection over a trusted local network. On macOS and other non-Pi hosts, add --host 0.0.0.0 when starting pico-bay to make it reachable from another computer. A Raspberry Pi listens on the LAN by default.

No authentication or TLS: MCP tools can run code, overwrite files, reset boards, and permanently delete board files. HTTP mode is intended only for a trusted local network. Do not expose /mcp or pico-bay’s port directly to the internet.

The server supports MCP revision 2026-07-28 and the legacy initialize flow through 2025-03-26. It uses plain JSON responses rather than SSE because it does not send server-initiated messages.

MCP tools

| Tool | Purpose | | --- | --- | | pico_boards_list | List connected boards, stable board IDs, firmware details, and capabilities. | | pico_files_list | List the board filesystem and report Flash and RAM usage. | | pico_file_read | Read a text or binary file using UTF-8 or base64. | | pico_file_write | Create or overwrite a UTF-8 or base64 file, up to 8 MB decoded. | | pico_directory_create | Create a directory. | | pico_path_rename | Rename or move a file or directory. | | pico_path_delete | Permanently delete a file or recursively delete a directory. | | pico_python_run | Run a file as __main__ or execute Python code and return its output. | | pico_board_interrupt | Send Ctrl-C to interrupt a running program. | | pico_board_reset | Soft-reset a board or request a supported hard reset. | | pico_board_bootloader | Put a board into BOOTSEL or ESP32 download mode for pico_install. | | pico_ctrlpi_install | Install or update the ctrlPi API agent on a Pico W, Pico 2 W, ESP32, ESP32-S3 or ESP32-C3. | | pico_install | Check and install MicroPython on a Pico in BOOTSEL mode or a supported ESP32 in DOWNLOAD mode. |

Call pico_boards_list first, then pass its board_id to board-specific tools. ZIP backup/restore, live console streaming, and Delete all files are intentionally not exposed through MCP.

Installing the ctrlPi API

On a board running MicroPython, Install ctrlPi API in the top-right menu turns it into a ctrlPi agent:

| Board | Agent | Files downloaded from GitHub | |---|---|---| | Pico W, Pico 2 W | pico-gpio-api | app.mpy, upgrader.mpy, main.py | | ESP32, ESP32-S3, ESP32-C3 | esp32-gpio-api | app.mpy, boot.py, upgrader.mpy, main.py |

app.mpy is the agent, precompiled, upgrader.mpy runs its over-the-air /upgrade, and main.py loads one of them. Fill in the API key, an optional agent name, and the WiFi SSID and password; pico-bay downloads the latest files, checks them, writes them (main.py last) together with config.json, wifi.txt and a sample scripts/cpu-temp.py sensor for that board, and resets it. The menu item is not shown on other boards (a Pico without WiFi, an ESP32-S2, or CircuitPython).

On a board that already runs the agent, the form is filled in from its current files, and its existing settings (pins, sensors, bridges) are kept: only the key and name are replaced, and an existing cpu-temp.py is left alone. A blank name keeps the agent's own default, pico-<serial4> or esp32-<serial4>.

Installing MicroPython in BOOTSEL mode

On a Pico running MicroPython or CircuitPython, select Reboot to BOOTSEL from the top-right menu and confirm. To enter manually, disconnect the board, hold its BOOTSEL button, and reconnect USB while continuing to hold it. Keep holding for 3 seconds, then release. pico-bay shows the RP2040 or RP2350 boot device as a red pill. Select it and choose if this is a W model (with Wi-Fi) or not, as it is not autodetectable. To cancel before installing firmware, unplug USB and plug it back in without holding any buttons.

pico-bay confirms the operation, downloads the latest matching MicroPython UF2 from micropython.org, validates it, and copies it to the boot volume. The screen reports the download, validation, installation, and reboot stages. Keep the board connected during installation. It reboots automatically and then appears as a normal MicroPython device.

ESP32 download mode

Select Enter download mode… from the top-right menu and confirm. For manual entry, hold BOOT/IO0, press and release RESET / EN, and keep holding BOOT/IO0 for 3 seconds, then release. Alternatively, unplug USB and hold BOOT/IO0. Plug the USB cable back in while continuing to hold BOOT/IO0. Keep holding for 3 seconds, then release. Click Scan in pico-bay, then select the red DOWNLOAD pill to see the detected chip and security details. To cancel before installing firmware, unplug USB and plug it back in without holding any buttons.

Select Install MicroPython to download, validate, install, and verify the latest official generic build. Erase and initialize storage is selected by default and runs after firmware verification, before reboot; uncheck it to preserve existing files. The screen shows each stage and the write progress percentage. Installation uses the ESP32 ROM without extra dependencies and is disabled when the chip is unsupported, unidentified, or protected by flash security.

Requirements

  • Node.js 20 or newer.
  • MacOS, Linux, Windows, or Raspberry Pi OS.
  • A USB-connected Raspberry Pi Pico or ESP32 board running MicroPython or CircuitPython, or a supported board in bootloader mode.
  • Permission to open the board's serial device.
  • On Windows, the .NET Framework v4 C# compiler (csc.exe) is required to build the serial helper automatically at startup.
  • For ESP32 on Windows, the appropriate serial driver installed (see Troubleshooting).
  • For ESP32 resets and download mode on macOS and Linux, Python 3 (standard library only), which drives the DTR and RTS lines.

Install

From GitHub:

git clone https://github.com/ctrlpi/pico-bay.git
cd pico-bay
npm start

Or install the npm package locally:

npm install @ctrlpi/pico-bay
npx pico-bay

Options

pico-bay [--port PORT] [--host ADDRESS] [--allow-host NAME] [--hold MILLISECONDS] [--no-open] [--mcp-stdio | --mcp-http | --no-mcp] [--help] [--version]
<table width="100%"> <thead> <tr> <th width="20%">Option</th> <th width="20%">Environment</th> <th width="13%">Default</th> <th width="47%">Purpose</th> </tr> </thead> <tbody> <tr> <td width="20%"><code>--port</code></td> <td width="20%"><code>PICO_PORT</code></td> <td width="13%"><code>7426</code></td> <td width="47%">Web server port.</td> </tr> <tr> <td width="20%"><code>--host</code></td> <td width="20%"><code>PICO_HOST</code></td> <td width="13%">Automatic</td> <td width="47%"><code>127.0.0.1</code> normally; <code>0.0.0.0</code> on a Raspberry Pi host.</td> </tr> <tr> <td width="20%"><code>--allow-host</code></td> <td width="20%"><code>PICO_ALLOW_HOSTS</code></td> <td width="13%">-</td> <td width="47%">Extra host name to accept, such as <code>pi4.lan</code>. Repeat the flag, or separate names with commas. IP addresses, <code>localhost</code> and the machine's own name always work.</td> </tr> <tr> <td width="20%"><code>--hold</code></td> <td width="20%"><code>PICO_HOLD_MS</code></td> <td width="13%"><code>900</code></td> <td width="47%">Idle time before releasing and soft-resetting the board.</td> </tr> <tr> <td width="20%"><code>--no-open

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars10
CategoryDevelopment
Updated7h ago
Forks0

Languages

JavaScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info