Portainer MCP. Run full DevOps operations via chat.
Portainer MCP connects your AI agent to your entire container infrastructure, letting you manage Docker and Kubernetes environments through natural conversation. You can list containers across multiple endpoints, spin up new services from images, start dormant apps, and connect to remote clusters—all without leaving your chat interface.
Give Claude and any AI agent real-world access
List every Docker container running or stopped within a specified environment.
Connect your AI agent to new or existing remote and local Docker/Kubernetes clusters (endpoints).
Create a brand-new container instance using a specific image name.
Bring a stopped or dormant container back online with one command.
Authenticate the MCP connection to generate temporary security tokens for authorized access.
Ask an AI about this
Waiting for input…
What AI agents can do with Portainer: 6 Tools for Container Ops
Use these tools to connect your AI agent to your container infrastructure, allowing you to manage environments, deploy services, and check status without leaving your conversation.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Portainer MCPAdd Endpoint
Connects the MCP to a new environment, like a remote Docker host or Kubernetes cluster.
Authenticate
Generates a temporary security token needed for all subsequent operations on the...
Create Docker Container
Builds and creates a new container instance using a specified image name.
Init Admin
Sets up the initial administrative password for a brand-new Portainer installation.
List Docker Containers
Retrieves and lists all existing containers, showing their current running or...
Start Docker Container
Restarts a container that is currently stopped or offline within the specified endpoint.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Portainer, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Portainer. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The Container Dashboard Click Fatigue
Right now, checking your infrastructure state involves a painful dance: logging into the staging dashboard, clicking through to the specific environment, finding the container list, and then if something's wrong, opening a second tab to figure out the restart command. It’s always clicks, tabs, copy-pasting—a massive context switch every time you need status.
With this MCP, all of that vanishes. You simply tell your agent what needs checking. The agent handles the connection, navigates the endpoints, and gives you a clean summary right where you are chatting. It takes hours of manual clicking down to a single conversation.
Portainer MCP: Container Ops in Conversation
You no longer need to remember the specific API calls or sequence of commands required for different environments. The agent abstracts that complexity away, letting you ask simple questions like, 'What's wrong with my test service?' and getting a direct answer.
It’s about control without friction. You gain total operational visibility over your entire container stack, making infrastructure management as natural as sending an email.
What Portainer MCP does for your AI
Managing complex container setups usually means jumping between a dashboard, writing docker-compose files, or remembering specific CLI commands for different environments. This MCP changes that. It lets you talk to your infrastructure instead of clicking through menus. You can connect your AI agent to any environment—local Docker hosts or remote Kubernetes clusters—and treat them all as one system.
Need to check the status of a service on an endpoint you haven't touched in weeks? Just ask. Want to deploy a new testing stack using a specific image? Tell your agent and watch it handle the creation process. Because Vinkius manages this catalog, you connect once from any compatible client and get immediate access to controlling all your core container operations.
It’s about giving your AI agent complete operational control over your entire service lifecycle.
019e38d9-6451-70e1-93ad-bf21ffd80161 How to set up Portainer MCP
The bottom line is that you control complex container operations conversationally instead of through a dashboard or terminal.
First, subscribe to this MCP and provide your Portainer URL along with the necessary API key.
Next, you instruct your AI agent on what needs doing—for example, 'list all containers in my staging environment.'
The system executes the required action against your infrastructure and reports the status directly back to your chat.
Who uses Portainer MCP
This MCP is for the DevOps Engineer who hates context-switching between dashboards and terminals. It's for developers who need to spin up temporary test environments on demand, and system admins managing dozens of remote clusters.
Running status checks across multiple development or staging endpoints without opening a browser tab.
Adding and managing entirely new remote Docker/Kubernetes environments from the chat interface.
Quickly deploying a test version of an application or service into a container for immediate testing.
Benefits of connecting Portainer MCP
You manage multiple remote clusters from one spot. The add_endpoint tool lets you connect to a staging cluster in AWS, and then immediately check its status alongside your local development container list.
Eliminate manual setup headaches. Use the init_admin tool right away on fresh installs so your agent can grab secure credentials and start working instantly.
Debugging is faster than ever. Instead of logging into a dashboard just to see what's wrong, ask your agent to list_docker_containers and get the status in three seconds.
Deployment becomes conversational. You tell your agent to create a service using create_docker_container, specifying the image and configuration parameters directly in the chat prompt.
Keep services online with zero effort. If an application container stops unexpectedly, you just ask your agent to start_docker_container instead of writing a restart command.
Portainer MCP use cases
Investigating Production Failures
An engineer notices latency spikes. They prompt their agent: 'List all containers in the production endpoint and tell me which ones are stopped.' The agent uses list_docker_containers to immediately pinpoint a misconfigured service that needs restarting.
Spinning Up Local Testing Environments
A developer needs a fresh copy of their API backend for testing. They ask the agent to deploy it using create_docker_container, specifying the required image and port settings, all from within their IDE chat window.
Onboarding New Infrastructure
The SysAdmin gets a new cluster endpoint URL. Instead of following a manual setup guide, they use add_endpoint through the agent, linking the whole remote system into their existing operational flow.
Recovering a Forgotten Service Instance
A critical caching service was accidentally stopped during maintenance. The administrator simply asks the agent to 'start the redis container in staging,' which executes start_docker_container instantly, restoring service.
Portainer MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Assuming connectivity
Telling the agent to list containers or start a service without first connecting it to the remote host. The operation will fail and waste time.
Always run add_endpoint first, pointing your MCP at the desired cluster URL. Once connected, you can then confidently use tools like list_docker_containers.
Forgetting credentials
Attempting any operation after an initial setup without securing the connection. The agent will reject the request because it lacks a valid token.
After setting up the endpoint, run authenticate to receive your JWT token. Your agent uses this token for every subsequent call.
Ignoring initial setup
Trying to use advanced features like deploying containers with custom JSON configurations without initializing admin rights first. The process will halt at a permission barrier.
If you're setting up Portainer for the first time, run init_admin immediately. This ensures your agent has the necessary starting credentials.
When to use Portainer MCP
Use this MCP if managing container lifecycle—listing, creating, or restarting services across diverse environments (Docker/K8s)—is a frequent task that involves multiple manual steps. It excels when you need to interact with infrastructure state conversationally.
Don't use it if your primary goal is complex CI/CD pipeline execution based on git hooks; dedicated pipeline tools are better for those workflows. Also, don't rely on this MCP for generating massive amounts of deployment YAML or writing application code—use a specialized coding agent for that. However, if you need to validate the state of containers after they've been deployed by another tool, Portainer is exactly what you need.
Frequently asked questions about Portainer MCP
How do I list containers using the Portainer MCP? +
You use the list_docker_containers tool. Just ask your agent to check a specific environment, and it will return a structured list showing all running and stopped services.
Can I connect multiple remote clusters with Portainer MCP? +
Yes. You use the add_endpoint tool to link various local or cloud-based Docker/Kubernetes environments, allowing your agent to treat them all as one resource pool.
What if a container is stopped? How do I restart it? +
Use the start_docker_container tool. You just need to give the agent the name of the service and the endpoint, and it handles bringing the instance back online.
Do I have to set up Portainer manually before using the MCP? +
Yes. For initial setup on a new system, you must first run init_admin to create the administrative credentials needed for the agent to gain access.
Can I deploy a brand-new container with Portainer MCP? +
Absolutely. Use the create_docker_container tool by telling your agent the exact image and name you want, and it handles deploying the service for you.