MCPs/portainer

portainer-mcp

MCP server for Portainer (Docker/K8s management).

Source: portainer-mcp (v0.5.1)

Environment Variables

Variable	Required	Description
PORTAINER_URL	Yes	Base URL of the Portainer instance (e.g. https://portainer.corentic.eu)
PORTAINER_USERNAME	Yes	Portainer username (use admin if using API key)
PORTAINER_PASSWORD	Yes	Portainer password or API key
PORTAINER_VERIFY_SSL	No	Verify SSL certificate (true/false, default: true)
PORTAINER_DEFAULT_ENDPOINT	No	Default endpoint ID (default: 1)
PORTAINER_TIMEOUT	No	Request timeout in seconds (default: 30)
PORTAINER_LONG_TIMEOUT	No	Long request timeout in seconds (default: 300)

Usage

docker run -d \
  --name portainer-mcp \
  -p 8110:8110 \
  -e PORTAINER_URL=https://portainer.corentic.eu \
  -e PORTAINER_USERNAME=admin \
  -e PORTAINER_PASSWORD=your_api_key_or_password \
  -e PORTAINER_VERIFY_SSL=false \
  forgejo.corentic.eu/corentic/mcp-fleet-portainer:latest

Tools

Auth & System

• portainer_status — Verify connection to Portainer and auth status
• portainer_docker_info — Docker system info. Params: endpoint_id
• portainer_docker_disk_usage — Docker disk usage. Params: endpoint_id

Endpoints (Environments)

• portainer_endpoints_list — List all environments (Docker/K8s endpoints)
• portainer_endpoint_inspect — Inspect endpoint details. Params: endpoint_id

Containers

• portainer_containers_list — List containers. Params: endpoint_id, all, limit, filters
• portainer_container_inspect — Inspect container. Params: endpoint_id, container_id
• portainer_container_start — Start container. Params: endpoint_id, container_id
• portainer_container_stop — Stop container. Params: endpoint_id, container_id
• portainer_container_restart — Restart container. Params: endpoint_id, container_id
• portainer_container_remove — Remove container. Params: endpoint_id, container_id, force, remove_volumes
• portainer_container_logs — Get container logs. Params: endpoint_id, container_id, tail, stdout, stderr
• portainer_container_logs_grep — Search container logs for pattern. Params: endpoint_id, container_id, pattern, tail, stdout, stderr
• portainer_container_stats — Get container stats (CPU, memory, etc.). Params: endpoint_id, container_id
• portainer_container_exec — Execute command in container. Params: endpoint_id, container_id, command, workdir, timeout

Stacks

• portainer_stacks_list — List stacks. Params: endpoint_id
• portainer_stack_inspect — Inspect stack. Params: stack_id
• portainer_stack_deploy — Deploy stack from compose. Params: endpoint_id, name, compose_content, env_vars
• portainer_stack_update — Update stack compose. Params: stack_id, endpoint_id, compose_content, env_vars, prune, pull_image
• portainer_stack_delete — Delete stack. Params: stack_id, endpoint_id
• portainer_stack_start — Start stack. Params: stack_id, endpoint_id
• portainer_stack_stop — Stop stack. Params: stack_id, endpoint_id
• portainer_stack_logs_errors — Scan stack container logs for errors. Params: endpoint_id, stack_name
• portainer_laravel_errors — Scan for Laravel errors in stack containers. Params: endpoint_id, stack_name
• portainer_laravel_tinker — Run Laravel tinker in container. Params: endpoint_id, stack_name, command, service

Images

• portainer_images_list — List images. Params: endpoint_id, with_usage
• portainer_image_inspect — Inspect image. Params: endpoint_id, image_ref
• portainer_image_pull — Pull image from registry. Params: endpoint_id, image, registry_auth
• portainer_image_remove — Remove image. Params: endpoint_id, image_ref, force

Networks

• portainer_networks_list — List networks. Params: endpoint_id
• portainer_network_inspect — Inspect network. Params: endpoint_id, network_id
• portainer_network_create — Create network. Params: endpoint_id, name, driver, subnet, gateway
• portainer_network_remove — Remove network. Params: endpoint_id, network_id
• portainer_network_connect — Connect container to network. Params: endpoint_id, network_id, container_id
• portainer_network_disconnect — Disconnect container from network. Params: endpoint_id, network_id, container_id, force

Volumes

• portainer_volumes_list — List volumes. Params: endpoint_id
• portainer_volume_inspect — Inspect volume. Params: endpoint_id, volume_id
• portainer_volume_create — Create volume. Params: endpoint_id, name, driver, labels
• portainer_volume_remove — Remove volume. Params: endpoint_id, volume_id, force

Users

• portainer_users_list — List Portainer users
• portainer_user_inspect — Inspect user. Params: user_id