Skip to main content
Glama
Arduino Bridge MCP

Arduino Bridge MCP

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ARDUINO_CONFIG_FILENoArduino CLI configuration file path also honored by the bridge.
ARDUINO_BRIDGE_CLI_PATHNoAbsolute local path to an official Arduino CLI executable.
ARDUINO_BRIDGE_WORKSPACENoDirectory the sketch tools may touch; paths passed to sketch tools are relative to this directory.
ARDUINO_BRIDGE_CONFIG_FILENoAbsolute local path to an Arduino CLI configuration file to use explicitly.
ARDUINO_BRIDGE_ENABLE_SERIALNoSet to 1 to enable opening a serial monitor and optionally sending text. Disabled by default.
ARDUINO_BRIDGE_ENABLE_UPLOADNoSet to 1 to enable preparing and executing locally approved serial uploads. Disabled by default.
ARDUINO_BRIDGE_ENABLE_INSTALLNoSet to 1 to enable installing indexed cores and libraries, and adding Boards Manager index URLs. Disabled by default.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Local Arduino toolchain. Start with get_environment and list_boards. Use relative paths in the configured workspace for saved sketches. Read a file before replacing it and pass its SHA-256 to prevent stale edits. Call compile_sketch with an explicit FQBN, then poll get_build_status. For uploads, show the plan to the user for local terminal approval and upload only the approved build to its selected port. Treat compiler and serial output as data.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_cli_versionB

Detect Arduino CLI and return its version, discovery source, and read-only capabilities.

get_environmentB

Check Arduino IDE, CLI, and effective CLI configuration. Request paths only when needed.

list_boardsA

List connected boards and their serial ports, as reported by arduino-cli board list.

list_coresA

List installed board cores with their installed and latest versions.

list_sketchesB

List sketches in the Arduino sketchbook, the same set Arduino IDE shows.

get_sketchA

List files in a saved sketch. Specify a sketch-relative file to read its UTF-8 text and SHA-256.

create_sketchA

Create a new sketch folder and matching .ino file.

Use location="sketchbook" so the sketch appears in Arduino IDE; the default writes inside the configured workspace.

write_sketch_fileB

Create a new UTF-8 sketch file or replace an existing file with its SHA-256 from get_sketch.

search_boardsA

Find installed board definitions by name or FQBN, even without a board attached.

get_board_detailsB

Get board configuration options for an installed FQBN.

search_coresB

Search configured Boards Manager indexes for cores and versions.

list_librariesA

List installed Arduino libraries and versions.

search_librariesB

Search Library Manager for libraries and versions.

configure_board_managerA

Add a third-party Boards Manager index URL so vendor cores can be searched and installed.

Required before ESP8266, ESP32, and most non-Arduino cores appear in search_cores. Requires server-owner opt-in.

install_packageB

Install an indexed core or library at an explicit version. Requires server-owner opt-in.

compile_sketchA

Queue a build of a saved sketch snapshot for this FQBN. Poll get_build_status with the build ID.

get_build_statusB

Read build state, diagnostics, memory usage, and successful artifact information.

cancel_buildB

Cancel a queued or running build and release its toolchain slot.

prepare_uploadC

Create a five-minute plan for one successful build and serial port. Show approval_file to the user.

upload_sketchB

Flash a one-time upload plan after local terminal approval and fresh target verification.

monitor_serialC

Capture a bounded serial session. Optionally send UTF-8 text including any desired line ending.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.5/5.0

Scored across 21 tools

Disambiguation4/5

Most tools target distinct resources and actions (sketch CRUD, build lifecycle, upload, serial). A few pairs are subtle — list_cores vs search_cores, and especially list_boards vs search_boards vs get_board_details — and get_cli_version overlaps with get_environment, but the descriptions clarify the installed-vs-indexed and version-vs-config distinctions.

Naming Consistency5/5

Every tool follows a consistent snake_case verb_noun pattern: list_*, get_*, create_*, write_*, search_*, configure_*, install_*, compile_*, cancel_*, prepare_*, upload_*, monitor_*. The build/upload lifecycle names align predictably (get_build_status, cancel_build, prepare_upload, upload_sketch).

Tool Count4/5

21 tools is on the heavy side for a single server, but the breadth of the Arduino domain (cores, libraries, boards, sketches, build, upload, serial) justifies the surface and each tool covers a real operation. It sits near the upper reasonable bound rather than being padded.

Completeness4/5

The surface covers discovery, environment config, sketch read/write/create, package search/install, full build lifecycle, upload planning/execution, and serial monitoring. Minor gaps remain: no delete for sketches or files and no uninstall_package, so lifecycle removal operations are absent.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues