Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

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

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

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

Tools

Functions exposed to the LLM to take actions

NameDescription
list_portsA

List serial ports, including the simulator, with a best-guess chip identification.

board_infoB

Chip family, flash size, MAC address, and MicroPython version (if any) for port.

flash_firmwareA

Write firmware_path to port.

Reports progress at least every 5% via MCP progress notifications and can be cancelled mid-flash. erase=True wipes the whole flash first and requires confirm_erase=True as a separate explicit argument.

repl_execA

Run code on port over MicroPython's raw REPL; stdout/stderr/exception come back separately.

fs_lsB

List a directory on the board's filesystem.

fs_getA

Read a file from the board. Content comes back base64-encoded; refuses files over max_bytes.

fs_putA

Write a base64-encoded payload to a file on the board, chunked over several raw-REPL exchanges.

tail_serialA

Capture raw serial output for up to 30 seconds without going through the REPL protocol.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.8/5.0

Scored across 8 tools

Disambiguation5/5

Each tool has a clear, distinct purpose: port discovery, board info, flashing, REPL execution, filesystem operations, and serial monitoring. There is no overlap between them, and even related tools like fs_ls/fs_get/fs_put are differentiated by operation type.

Naming Consistency3/5

Naming patterns are mixed: some are verb_noun (list_ports, flash_firmware, tail_serial), some are prefix-based (fs_ls, fs_get, fs_put), and repl_exec inverts the usual order. While readable, the lack of a single consistent convention makes the API slightly less predictable.

Tool Count5/5

With exactly 8 tools, the server is well-scoped for its purpose of managing ESP32 boards. Each tool covers a distinct aspect of the workflow (discovery, flashing, code execution, filesystem, serial) without bloat or trivial tools.

Completeness4/5

The toolset covers the core lifecycle: identify port, get board info, flash firmware, execute code, and manage files. The only notable gap is lack of a delete/rename filesystem operation, but this is a minor omission that doesn't compromise the primary workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues