Skip to content

portainer/portainer-mcp

v2.42.6 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

Published 1mo MCP SaaS Integrations
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

ai containerization llm mcp mcp-server portainer

Summary

AI summary

Claude Desktop one-click .mcpb bundles add self‑contained PyInstaller binaries for macOS, Windows, and Linux.

Full changelog

2.42.6 — Targets Portainer 2.42.x

Added

  • Claude Desktop one-click .mcpb bundles (#72). The server now ships as a
    self-contained PyInstaller binary bundle (no Python/uv/Node needed on the
    client), built per-platform (darwin-arm64, win32-x64, linux-x64) and
    attached to this release. Bundles are unsigned for now — see the
    Gatekeeper/SmartScreen workaround in
    docs/distribution/claude-desktop.md.
  • Bundled hygiene guidance, served on demand via a get_guidance tool (#72).
    The full portainer-mcp-hygiene skill now ships with every install method
    (uvx, container, .mcpb) from the same SKILL.md, so it can't drift. A
    one-time-per-session gate requires get_guidance so the guide reliably lands
    in context rather than relying on the truncatable instructions field. A
    missing guide is now a hard startup failure.

Changed

  • Hygiene skill guidance expanded (#71) to cover mutations and typed
    Kubernetes field shapes, and to report its own gaps (failing select
    examples, redaction/truncation mismatches, missing tools) as scrubbed,
    consent-gated issues against portainer/portainer-mcp.

Removed

  • Manual hygiene-skill curl install instructions (README,
    docs/distribution/claude-desktop.md). The guide is now bundled and served
    via get_guidance, so the curl snippets were redundant and drift-prone.

Full changelog: https://github.com/portainer/portainer-mcp/blob/2.42.6/CHANGELOG.md

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track portainer/portainer-mcp

Get notified when new releases ship.

Sign up free

About portainer/portainer-mcp

Portainer MCP server

All releases →

Related context

Earlier breaking changes

  • v2.42.5 Breaks HTTP-transport deployments: per-user Portainer API-key passthrough required; `PORTAINER_API_KEY` now hard-fails at startup under `PORTAINER_MCP_TRANSPORT=http`.
  • v2.42.1 Breaks `make dev` to now require PORTAINER_MCP_AUTH_TOKEN for local HTTP loop.

Beta — feedback welcome: [email protected]