Arduino MCP Server

NPM · ARDUINO-MCP-SERVER · SCANNED AUG 3

Arduino MCP server for CLI setup, board detection, compile/upload, serial monitoring, and pin refs.

Available components

+17 this week 69 69 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security86

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 148 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability81

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (good).Pass
Tool/resource definitions use about 1535 tokens (~69/item across 22 items; 21 tools + 1 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage94

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
79% of tool parameters carry a description.Partial
Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · arduino-mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add hardware-mcp-arduino-mcp-server -- npx -y arduino-mcp-server

# add to Codex CLI

codex mcp add hardware-mcp-arduino-mcp-server -- npx -y arduino-mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hardware-mcp-arduino-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "arduino-mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add hardware-mcp-arduino-mcp-server --command npx --arg -y --arg arduino-mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  hardware-mcp-arduino-mcp-server:
    command: "npx"
    args: ["-y", "arduino-mcp-server"]

// mcp.json

{
  "mcpServers": {
    "hardware-mcp-arduino-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "arduino-mcp-server"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +43
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Schema quality: 100 → unverified ▼ functional
- Security disclosure: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Schema quality: unverified → good ▲ functional
- Licence: MIT functional
31 Jul 26 −8
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 52

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 21 exposed · ~1,516 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

arduino_cli_doctor Arduino CLI Doctor ~27

Check whether arduino-cli is available and return OS-specific installation instructions if missing.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

compile_sketch Compile Sketch ~131

Compile an Arduino sketch with a specific board FQBN.

Input Output Examples

Name	Type	Req	Description
autoInstallCore	boolean	—	If true (default), auto-install missing board core before compile.
buildPath	string	—	Optional build output directory.
clean	boolean	—	If true, clean build cache before compile.
exportBinaries	boolean	—	If true, export binaries into sketch folder.
fqbn	string	yes	Board FQBN, e.g. arduino:avr:uno.
sketchPath	string	yes	Path to sketch folder or .ino file.
warnings	string	—	—

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

detect_hardware Detect Hardware ~80

Detect connected Arduino-compatible hardware, infer board/FQBN candidates, and generate next compile/upload commands.

Input Output Examples

Name	Type	Req	Description
includeBoardDetails	boolean	—	If true, query `arduino-cli board details` for selected FQBN candidates.
port	string	—	Optional exact port filter, e.g. COM6 or /dev/ttyACM0.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

ensure_core_installed Ensure Core Installed ~92

Ensure the Arduino core required by a board FQBN is installed. Can auto-install via `arduino-cli core install`.

Input Output Examples

Name	Type	Req	Description
autoInstall	boolean	—	If true (default), install missing core automatically.
coreId	string	—	Core ID, e.g. arduino:avr.
fqbn	string	—	Board FQBN, e.g. arduino:avr:uno.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

get_board_details Get Board Details ~46

Get detailed board metadata from arduino-cli for a specific FQBN.

Input Output Examples

Name	Type	Req	Description
fqbn	string	yes	Board FQBN, e.g. arduino:avr:uno.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

install_arduino_cli Install Arduino CLI ~83

Attempt to install arduino-cli for the current OS using available package managers, then verify and configure CLI path.

Input Output Examples

Name	Type	Req	Description
method	string	—	Install method. Default `auto` tries OS-relevant methods in order.
setCliPathInProcess	boolean	—	If true (default), set ARDUINO_CLI_PATH in this MCP process after install.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

list_board_reference List Board Reference ~19

List local board reference entries with pin/spec metadata.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

list_connected_boards List Connected Boards ~22

List connected boards and serial ports detected by arduino-cli.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

list_serial_ports List Serial Ports ~29

List serial ports and any detected board metadata using arduino-cli. Works on Windows/macOS/Linux.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

list_supported_boards List Supported Boards ~40

List supported/installable boards from the local arduino-cli index.

Input Output Examples

Name	Type	Req	Description
search	string	—	Optional case-insensitive filter for name/FQBN.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

read_serial_snapshot Read Serial Snapshot ~73

Capture serial output for a bounded duration from a given port.

Input Output Examples

Name	Type	Req	Description
baudRate	integer	—	Baud rate. Default: 9600.
durationMs	integer	—	Capture duration in ms.
port	string	yes	Serial port path, e.g. COM6 or /dev/ttyACM0.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

safety_preflight Safety Preflight ~84

Run electrical preflight checks (voltage/current/pin risks) before upload or serial write operations.

Input Output Examples

Name	Type	Req	Description
board	string	—	Board name/id (preferred when known).
fqbn	string	—	Board FQBN when known.
port	string	—	Optional port for automatic board inference.
power	object	—	—
wiring	array	—	—

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

search_board_reference Search Board Reference ~33

Search local board reference by board name, alias, id, or FQBN.

Input Output Examples

Name	Type	Req	Description
query	string	yes	—

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

serial_close_session Serial Close Session ~27

Close a serial session and release its port lock.

Input Output Examples

Name	Type	Req	Description
sessionId	string	yes	—

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

serial_expect Serial Expect ~64

Wait for a string pattern in a serial session buffer with timeout.

Input Output Examples

Name	Type	Req	Description
caseSensitive	boolean	—	—
fromOffset	integer	—	Optional explicit cursor offset.
pattern	string	yes	—
sessionId	string	yes	—
timeoutMs	integer	—	—

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

serial_list_sessions Serial List Sessions ~19

List active serial sessions and current port lock state.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

serial_open_session Serial Open Session ~88

Open a stateful serial monitor session with port lock ownership.

Input Output Examples

Name	Type	Req	Description
baudRate	integer	—	Baud rate. Default: 9600.
maxBufferBytes	integer	—	Max in-memory receive buffer.
port	string	yes	Serial port path, e.g. COM6 or /dev/ttyACM0.
ttlMs	integer	—	Session lease TTL in ms.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

serial_read Serial Read ~68

Read buffered bytes from an open serial session.

Input Output Examples

Name	Type	Req	Description
encoding	string	—	Output encoding. Default: utf8.
fromOffset	integer	—	Read offset cursor. Defaults to current buffer start.
maxBytes	integer	—	Maximum bytes to return.
sessionId	string	yes	—

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

serial_write Serial Write ~103

Write bytes to an open serial session. Safety preflight is enforced unless explicitly skipped.

Input Output Examples

Name	Type	Req	Description
data	string	yes	Payload to send.
encoding	string	—	Payload encoding. Default: utf8.
lineEnding	string	—	Optional line ending append.
safetyContext	object	—	—
sessionId	string	yes	—
unsafeSkipPreflight	boolean	—	If true, bypasses safety_preflight checks. Use only with explicit user acceptance.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

upload_and_wait_ready Upload And Wait Ready ~231

Upload a sketch and wait for a serial readiness pattern, handling post-upload reset/re-enumeration windows.

Input Output Examples

Name	Type	Req	Description
autoInstallCore	boolean	—	If true (default), auto-install missing board core when fqbn is provided.
fqbn	string	—	Optional board FQBN when auto-detect is insufficient.
port	string	yes	Serial port path, e.g. COM6 or /dev/ttyACM0.
readyBaudRate	integer	—	Baud rate for readiness check. Default 115200.
readyCaseSensitive	boolean	—	If true, readiness matching is case-sensitive.
readyPattern	string	—	Optional serial text pattern to wait for after upload.
readyTimeoutMs	integer	—	How long to wait for readyPattern.
safetyContext	object	—	—
sketchPath	string	yes	Path to sketch folder or .ino file.
unsafeSkipPreflight	boolean	—	If true, bypasses safety_preflight checks. Use only when user explicitly accepts risk.
verify	boolean	—	Verify uploaded binary when supported.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

upload_sketch Upload Sketch ~157

Upload a compiled sketch to a connected board/port.

Input Output Examples

Name	Type	Req	Description
autoInstallCore	boolean	—	If true (default), auto-install missing board core when fqbn is provided.
fqbn	string	—	Optional board FQBN when auto-detect is insufficient.
port	string	yes	Serial port path, e.g. COM6 or /dev/ttyACM0.
safetyContext	object	—	Optional electrical context for preflight checks.
sketchPath	string	yes	Path to sketch folder or .ino file.
unsafeSkipPreflight	boolean	—	If true, bypasses safety_preflight checks. Use only when user explicitly accepts risk.
verify	boolean	—	Verify uploaded binary when supported.

Name	Type	Req	Description
command	string	—	—
data	—	—	—
error	string	—	—
errorCode	string	—	—
nextActions	array	—	—
note	string	—	—
ok	boolean	yes	—
raw	object	—	—
rawTail	object	—	—
reasonCodes	array	—	—
retryable	boolean	—	—
stage	string	—	—
status	string	—	—

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug