Skip to content

portainer/portainer-mcp

v2.43.1 Breaking

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

Published 24d 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

Affected surfaces

breaking_upgrade

Summary

AI summary

gitops tag added to default profile set and new GITOPS profile bundles GitOps source management.

Full changelog

2.43.1 — Targets Portainer 2.43.x

Added

  • New GITOPS profile (#74) bundling the gitops tag — register/list/test
    git sources and browse refs (the GitOps source management surface).
  • JMESPath errors now diagnose double-escaped quotes. When a select
    expression fails to parse and contains literal \" (the JSON-in-JSON
    double-escaping models fall into), the error names the cause and suggests
    plain double quotes or a contains(...) filter instead of the lexer's
    opaque Unknown token message.
  • Hygiene guide: four field-tested additions from agent usage reports — the
    backslash-escaping trap and its contains() workaround; the 400 … EOF
    rejection when a write call sends zero body fields (e.g. a bare
    StackGitRedeploy — pass Prune: false); verifying a K8s deploy end-to-end
    via the service-proxy path; and which StackCreateKubernetesGit fields are
    the blessed path (SourceID) vs the still-functional deprecated inline
    Repository* fields.

Changed

  • gitops is now in the default profile set (#74). A
    registered GitOps source is required to deploy a git-backed stack, so gitops
    now rides along inside both DOCKER and KUBERNETES (next to stacks) and
    the default PORTAINER_PROFILES becomes BASE,DOCKER,KUBERNETES,GITOPS.
    Without it, git-based stack deploys fail for lack of a source.

Full changelog: https://github.com/portainer/portainer-mcp/blob/2.43.1/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]