Repository navigation
Releases
Releases · powerdragonfire/platformio.mcp
v0.9.0
Changed
- The PostHog MCP SDK path no longer sends tool argument values (
$mcp_parameters), tool results ($mcp_response), error text ($mcp_error_message) or$exceptionevents. Abefore_sendfilter removes them, so remote events hold what the README lists (#34, thanks electron-rare). - Agent-written intent text (the injected
contextargument) andget_more_toolsmissing-capability reports are off by default. SetPLATFORMIO_MCP_ANALYTICS_INTENT=1to send them. Without it,$mcp_intentisInvoking <tool name>.
v0.8.0
Added
pio_decode_backtraceunwinds RISC-V ESP32 panics (C2, C3, C5, C6, C61, H2, H4, P4, S31) into a full call chain. The register dump andStack memory:block go to the toolchain'sriscv32-esp-elf-gdbthrough Espressif'sesp-idf-panic-decoder, now a dependency.pio_flash_and_verifygets the same decoding on a crash. Results carryarch,method(gdb_unwind,stack_scanoraddr2line) and the crashedcore. Prompted by Jason2866's ESP-Decoder; seedocs/adr/0001-riscv-unwinding-via-esp-idf-panic-decoder.mdfor why the code comes from Espressif.- Without GDB, RISC-V decoding symbolizes
MEPC,RAand stack words that point into code (role: stack_scan), and the summary gives the command that installs GDB. - README section on pioarduino: tested tools, the Python 3.10 to 3.14 requirement, and the ESP32-C2 hybrid-compile rebuild.
- Multi-core RISC-V panic output is cut down to the core named in
Core N panic'ed. A serial buffer holding several crashes decodes the last one, with that crash's registers, cause and reset reason only.
Fixed
pio_partition_tablefinds the framework's default partition CSV on pioarduino, which splits the Arduino framework intoframework-arduinoespressif32andframework-arduinoespressif32-libs.A0in a RISC-V register dump is no longer reported as a return address. It is the first function argument on RISC-V and usually points at data.
Changed
- Release workflow uses
actions/upload-artifactv7 andactions/download-artifactv8.
Security
opentelemetry-api1.45.2 in the lock file fixes quadratic-timetraceparentparsing that allowed denial of service (Dependabot alert 5).
v0.7.0
Added
pio_system_infolists globally installed platforms and tool packages (name, version, path), so an agent can inspect the toolchain without a project.pio_buildacceptsenvs=[...]to build several environments in one call. Envs build one after another, a failing env does not stop the rest, and the result reports status, errors and memory per env.
Changed
pio_monitor_readreturnsok:falsewitherror: pattern_timeout(orsession_closed) whenwait_fornever matches, with the lines seen so far and a cursor to continue from. Reads withoutwait_forare unchanged.
v0.6.2
Changed
- Enable PostHog SDK intent context and missing-capability reporting using the release ingestion key by default, preserving token overrides, opt-outs, and a single remote sender.
- Ask agents to describe goals in context and report unsupported capabilities through
get_more_tools; document agent participation and context delivery.
v0.6.1
Added
- Report available model and reasoning-effort metadata with provenance on both analytics paths, with explicit environment fallbacks. Expose the running release as
platformio_mcp_versionalongside$mcp_server_version. - Optional original prompt capture from explicit host metadata, disabled by default and bounded to 2,000 characters when users enable
PLATFORMIO_MCP_CAPTURE_PROMPTS=1. - Codex marketplace and compatibility manifest, portable MCP configuration, and documented Claude/Codex plugin installation. Plugin installs bundle PlatformIO Core through the existing extra.
- Enable the PostHog SDK's missing-capability reporting tool.
Fixed
- Wait for the GDB prompt following the initial stop before accepting commands, preventing a delayed startup prompt from making a running command appear complete on macOS.
v0.6.0
Changed
- Add the PostHog MCP SDK when
POSTHOG_PROJECT_TOKENis set and remote analytics are allowed. The built-in recorder retains the local log and custom endpoint while the SDK handles PostHog delivery, preventing duplicate events. - Allow PostHog SDK updates within
>=7.86.6,<8.
Fixed
- Explicitly enable SDK context capture and infer intent from registered tool names when agents omit context or send an empty value. Preserve non-empty agent context and label fallback intent as inferred.
- Respect analytics opt-outs and CI before creating the SDK client. Importing the server no longer creates a PostHog client or emits a missing-token warning.
- Flush and close the SDK client during normal shutdown, ignoring cleanup failures. Remove the SDK SIGTERM handler and forced process exit.
v0.5.0
Added
- PostHog events carry
$session_id(the per-process session),$mcp_source,$lib_version, and$mcp_protocol_version, so PostHog's MCP analytics Sessions tab and per-tool session counts work. $mcp_initializeand$mcp_tools_list(with$mcp_listed_tool_names) go to PostHog once per process each. Tools listed and never called become visible.- Tool-call events keep the
boardandplatformargument values when they are PlatformIO registry ids such asesp32devorespressif32. Paths and URLs in those arguments are dropped. All other argument values stay out.
Changed
- PostHog events go out through
/batch/in batches of up to 20 events or every 5 seconds, in place of one POST per event. Server shutdown flushes the open batch for up to 2 seconds. The local log andPLATFORMIO_MCP_ANALYTICS_URLare unchanged.
v0.4.1
Changed
- PostHog usage events are now
$mcp_tool_callwith PostHog's MCP property names ($mcp_tool_name,$mcp_is_error,$mcp_error_type,$mcp_duration_ms,$mcp_client_name, ...). PostHog's MCP analytics views now break calls down by tool and client. 0.4.0 sent the same data astool_call.
v0.4.0
Added
- Usage analytics: one JSON line per tool call in
~/.platformio-mcp/analytics/usage.jsonlwith tool, ok, error code, duration, argument names, and MCP client. Argument values, paths, ports, and serial output are never recorded.PLATFORMIO_MCP_ANALYTICS=offdisables it, andPLATFORMIO_MCP_ANALYTICS_URLalso POSTs each event to your own endpoint. - Anonymous usage events to PostHog EU Cloud, keyed by a random install id with no person profile. Off under
DO_NOT_TRACK=1,PLATFORMIO_MCP_ANALYTICS=local, or whenCIis set. The first sending run prints a notice on stderr. platformio.mcp statssummarises the usage log: calls, ok rate, and p50/p95 duration per tool, top errors, and clients.
Changed
- Releases tag themselves: merging a pull request that bumps the version makes
publish.ymlcreate thevX.Y.Ztag, publish to PyPI, and create the GitHub release. A release no longer needs a separate PR or a manual tag push.
v0.3.1
Security
- CI and release workflows now default the
GITHUB_TOKENtocontents: read. Only the PyPI job (id-token: write) and the GitHub release job (contents: write) get more.