Compatible with every major AI agent and IDE
What is the Portainer MCP Server?
Connect your Portainer instance to any AI agent and orchestrate your containerized infrastructure through natural conversation.
What you can do
- Container Management — List all Docker containers in any environment, create new ones from images, and start existing containers.
- Environment Orchestration — Add and manage new local or remote Docker/Kubernetes environments (endpoints) to your Portainer setup.
- Admin Control — Initialize admin accounts on fresh installations and authenticate to receive secure JWT tokens.
- Configuration Control — Deploy containers with custom configurations, including exposed ports and host settings via JSON.
How it works
- Subscribe to this server
- Enter your Portainer URL and API Key
- Start managing your devops infrastructure from Claude, Cursor, or any MCP-compatible client
Who is this for?
- DevOps Engineers — quickly check container statuses and restart services without leaving the terminal or chat.
- Developers — deploy new testing environments or images directly from the code editor.
- System Administrators — manage multiple remote environments and endpoints through a unified AI interface.
Built-in capabilities (6)
Add a new environment (endpoint) to Portainer
Authenticate to receive a JWT token
Create a new Docker container
Initialize Portainer admin password
List Docker containers in an environment
Start a Docker container
Why AutoGen?
AutoGen enables multi-agent conversations where agents negotiate, delegate, and collaboratively use Portainer tools. Connect 6 tools through Vinkius and assign role-based access. a data analyst queries while a reviewer validates, with optional human-in-the-loop approval for sensitive operations.
- —
Multi-agent conversations: multiple AutoGen agents discuss, delegate, and collaboratively use Portainer tools to solve complex tasks
- —
Role-based architecture lets you assign Portainer tool access to specific agents. a data analyst queries while a reviewer validates
- —
Human-in-the-loop support: agents can pause for human approval before executing sensitive Portainer tool calls
- —
Code execution sandbox: AutoGen agents can write and run code that processes Portainer tool responses in an isolated environment
Portainer in AutoGen
Portainer and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Portainer to AutoGen through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for Portainer in AutoGen
The Portainer MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 6 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in AutoGen only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
Portainer for AutoGen
Every tool call from AutoGen to the Portainer MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
How do I see all containers running in a specific environment?
Use the list_docker_containers tool by providing the specific endpoint_id. The agent will return a list of all containers managed within that Portainer environment.
Can I add a new remote Docker endpoint through the AI?
Yes! Use the add_endpoint action. You can specify the name, set the type to 2 (Remote), and provide the URL (e.g., tcp://10.0.0.1:2375) to connect a new environment.
Is it possible to deploy a container with specific port mappings?
Yes. When using create_docker_container, you can provide a config_json string containing standard Docker API parameters like ExposedPorts or HostConfig to define your network and port requirements.
How does AutoGen connect to MCP servers?
Create an MCP tool adapter and assign it to one or more agents in the group chat. AutoGen agents can then call Portainer tools during their conversation turns.
Can different agents have different MCP tool access?
Yes. AutoGen's role-based architecture lets you assign specific MCP tools to specific agents, so a querying agent has different capabilities than a reviewing agent.
Does AutoGen support human approval for tool calls?
Yes. Configure human-in-the-loop mode so agents pause and request approval before executing sensitive MCP tool calls.
McpWorkbench not found
Install: pip install "autogen-ext[mcp]"
Explore More MCP Servers
View all →
Erply ERP & POS
10 toolsEquip your AI agent to manage retail products, track sales invoices, and monitor inventory via the Erply API.

BugSnag
10 toolsMonitor application errors via BugSnag — track stability, inspect error groups, and retrieve event details directly from any AI agent.

Cal.com
12 toolsLet anyone book time with you through customizable scheduling pages that sync with your calendar and eliminate back-and-forth.

Guance Cloud / 观测云
10 toolsModern observability platform — manage monitors, dashboards, and events via AI.
