Loading...
Portainer MCP connects AI assistants to Portainer, enabling management of container environments via AI using the Model Context Protocol.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
Portainer MCP connects AI assistants to Portainer, enabling management of container environments via AI using the Model Context Protocol.
Portainer MCP offers a read-only mode for safe exploration, but its ability to execute Docker and Kubernetes commands poses risks. Exercise caution when granting write access, especially in production environments.
Performance depends on the Portainer API and network latency. Large requests may take longer to process.
Cost depends on Portainer infrastructure and API usage. Consider rate limiting to prevent excessive API calls.
brew install cloc{
"mcpServers": {
"portainer": {
"command": "/path/to/portainer-mcp",
"args": [
"-server",
"[IP]:[PORT]",
"-token",
"[TOKEN]",
"-tools",
"/tmp/tools.yaml"
]
}
}
}ListEnvironmentsLists all available Portainer environments.
Read-only operation; no modifications.
UpdateEnvironmentTagsUpdates tags associated with a Portainer environment.
Modifies environment metadata, but not critical settings.
CreateEnvironmentGroupCreates a new environment group in Portainer.
Adds a new resource, but doesn't directly impact existing environments.
UpdateEnvironmentGroupNameUpdates the name of an environment group.
Modifies the name of a resource.
ListStacksLists all available stacks in Portainer.
Read-only operation; no modifications.
GetStackFileRetrieves the compose file for a specific stack.
Read-only operation; no modifications.
CreateStackCreates a new Docker stack in Portainer.
Creates a new stack based on a compose file.
UpdateStackUpdates an existing Docker stack in Portainer.
Modifies the configuration of an existing stack.
ListUsersLists all available users in Portainer.
Read-only operation; no modifications.
UpdateUserUpdates an existing user in Portainer.
Modifies user attributes, potentially affecting access control.
DockerProxyProxies arbitrary Docker API requests to the Portainer environment.
Allows execution of any Docker command, including potentially destructive ones.
KubernetesProxyProxies arbitrary Kubernetes API requests to the Portainer environment.
Allows execution of any Kubernetes command, including potentially destructive ones.
getKubernetesResourceStrippedProxies GET Kubernetes API requests and strips verbose metadata.
Read-only operation, retrieves data and removes verbose metadata.
API Key
cloud
Portainer MCP offers a read-only mode for safe exploration, but its ability to execute Docker and Kubernetes commands poses risks. Exercise caution when granting write access, especially in production environments.
Autonomy depends on the configured tools and permissions. Exercise caution when granting full access to AI agents.
Production Tip
Use read-only mode in production environments to minimize the risk of unintended modifications.
The tool supports specific Portainer versions as listed in the documentation. Use the `-disable-version-check` flag at your own risk.
Configure the tool with the Portainer server address, API token, and path to the tools.yaml file.
Add the `-read-only` flag to the command arguments.
Yes, you can customize the tools by modifying the tools.yaml file.
The tool can execute arbitrary Docker and Kubernetes commands, posing a significant security risk if not properly configured.
Download the corresponding .md5 checksum file and use the `md5` or `md5sum` command to verify the checksum.
The tools.yaml file defines the available tools and their parameters, allowing you to customize the functionality exposed to AI models.