portainer-agent¶

Portainer container-management MCP Server + A2A Agent for the agent-utilities ecosystem — Docker environments, stacks, Kubernetes clusters, registries, users, and edge devices through one typed tool surface.

Official documentation

This site is the canonical reference for portainer-agent, maintained alongside every release.

Overview¶

portainer-agent wraps the Portainer REST API with typed, deterministic MCP tools and ships an optional A2A agent server. It provides:

PortainerApi — a composed REST client covering authentication, environments, Docker, stacks, Kubernetes, edge devices, templates, users, registries, and system.
Ten action-dispatch MCP tools — one per management domain (portainer_auth, portainer_docker, portainer_stack, portainer_kubernetes, portainer_edge, portainer_template, portainer_user, portainer_registry, portainer_environment, portainer_system), each gated by a *TOOL toggle.
An A2A agent server (portainer-agent console script) that routes natural-language requests to the relevant domain through a confidence-gated graph orchestrator.

Explore the documentation¶

Installation — pip, source, extras, and the prebuilt Docker image.
Deployment — run the MCP server and the A2A agent, Docker Compose, Caddy + Technitium.
Usage — the MCP tools, the PortainerApi client, and the CLI.
Backing Platform — deploy Portainer with Docker.
Overview — modes, environment variables, graph routing.
Concepts — the CONCEPT:PORT-* registry.

Quick start¶

pip install portainer-agent
portainer-mcp                    # stdio MCP server (default transport)

Connect it to a Portainer instance:

export PORTAINER_URL=http://your-portainer:9000
export PORTAINER_TOKEN=your_api_token
portainer-mcp --transport streamable-http --host 0.0.0.0 --port 8000

See Installation and Deployment for the full matrix (PyPI extras, Docker image, all transports, the agent server, reverse proxy, DNS).