// MCP TOOL REFERENCE

CROSSPAD TOOLS

28 tools from the Crosspad MCP Server, categorised by risk level.

// ALL 28 CROSSPAD TOOLS

READ 18 tools

Read crosspad_apps_list List apps from the crosspad-apps registry, aggregating installation status across all detected platform rep... Read crosspad_apps_sync Sync a platform Read crosspad_capabilities List platform capability flags (Capability enum) and which capabilities each platform sets. Read crosspad_check Health check for a build — detects stale exe, new sources missing from build system, dirty submodules. Use ... Read crosspad_devices List all connected USB serial devices. Identifies CrossPad devices (Espressif VID 0x303a, PID 0x3456) separ... Read crosspad_flash Flash firmware to a connected CrossPad device. transport= Read crosspad_interface_implementations Find all classes implementing a given interface across CrossPad repos. Returns className, file path, platform. Read crosspad_kill Stop the running PC simulator. Identifies the process by /proc/<pid>/exe match against the built binary (Li... Read crosspad_list_apps_source List apps registered via REGISTER_APP() macro by scanning source files. Different from crosspad_apps_list (... Read crosspad_list_interfaces List all crosspad-core interfaces (I*-prefixed classes in crosspad-core/include/crosspad/). Read crosspad_log Capture logs from PC simulator (target= Read crosspad_repo_diff Show submodule drift in a parent repo (crosspad-pc or platform-idf): commits ahead/behind pinned, changed f... Read crosspad_repo_status Git status across ALL detected CrossPad repos in one call: branch, HEAD, dirty files, submodule sync state.... Read crosspad_screenshot Capture a PNG screenshot from the running PC simulator. By default saves to disk and returns the file_path.... Read crosspad_search_symbols Search for symbol DEFINITIONS (classes, functions, macros, enums, typedefs) across CrossPad repos via git g... Read crosspad_settings_get Read settings from the running simulator. Read crosspad_stats Read runtime statistics from the running PC simulator: pad state, capabilities, heap, registered apps, acti... Read crosspad_test_run Build and run the Catch2 test suite for crosspad-pc. PREFER THIS over invoking the test binary directly — c...

WRITE 7 tools

Write crosspad_apps_install Install an app from the crosspad-apps registry as a git submodule. Requires gh CLI authenticated. Delegates... Write crosspad_apps_update Update one or all installed apps on a platform. Specify app_name OR set update_all=true. Write crosspad_commit Commit staged changes in a specific CrossPad repo. PREFER THIS over raw Write crosspad_input Send a single input event to the running PC simulator (consolidated tool — replaces 7 separate tools in v6)... Write crosspad_midi Send a single MIDI event to the running simulator (consolidated tool — replaces 4 separate tools in v6). Re... Write crosspad_settings_set Write a single setting on the running simulator. Write crosspad_submodule_update Update a submodule in a parent repo to the latest commit on a tracking branch (git fetch + checkout origin/...

DESTRUCTIVE 1 tools

Destructive crosspad_apps_remove Remove an installed app submodule from a platform repo. Delegates to app_manager.py.

EXECUTE 2 tools

Execute crosspad_build Build CrossPad for the given platform. platform=pc → CMake + Ninja host simulator (PREFER THIS over Execute crosspad_run Launch the built simulator binary in the background. Returns pid + exe_path. Refuses to spawn a duplicate i...

// RUNNING THIS SERVER

The managed route: connect Crosspad through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y crosspad-mcp-server

// FAQ

How many tools does the Crosspad MCP server have? +

The Crosspad MCP server exposes 28 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Crosspad tools? +

Route the Crosspad server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Crosspad tools fall into? +

Crosspad tools are categorised as Read (18), Write (7), Destructive (1), Execute (2). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.