Skip to content

portainer/portainer-mcp

v2.43.3 Feature

This release adds 2 notable features for engineering teams evaluating rollout.

✓ 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

Configurable upstream timeout raises default to 120s and clarifies write‑timeout ambiguity.

Full changelog

2.43.3 — Targets Portainer 2.43.x

Added

  • Configurable upstream timeout (PORTAINER_TIMEOUT, seconds) — #80. The
    upstream Portainer HTTP timeout was hardcoded at 30s, routinely too short for
    stack creation (Portainer deploys synchronously — the request holds open
    through image pull and compose up). The default rises to 120s, the
    connect phase stays capped at 10s so an unreachable Portainer still
    fails fast, and the knob applies to both transports. Non-numeric or
    non-positive values refuse to boot; the resolved posture is logged at
    startup.

Changed

  • Post-send timeouts now say the write may have succeeded (#80). A
    request that times out after reaching Portainer is ambiguous, not failed
    — Portainer keeps processing, which is how two timed-out stack creates
    left two stack records behind in #80. FastMCP's stock error ("please
    retry") invites exactly the duplicate-creating reflex, so
    ReadTimeout/WriteTimeout errors are rewritten to name the ambiguity,
    instruct the model to verify current state (e.g. StackList) before
    retrying, and point at PORTAINER_TIMEOUT. Connect-phase timeouts are
    left untouched — the request never reached Portainer.

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