Portainer MCP Server for AutoGenGive AutoGen instant access to 6 tools to Add Endpoint, Authenticate, Create Docker Container, and more
Microsoft AutoGen enables multi-agent conversations where agents negotiate, delegate, and execute tasks collaboratively. Add Portainer as an MCP tool provider through Vinkius and every agent in the group can access live data and take action.
Ask AI about this MCP Server for AutoGen
The Portainer MCP Server for AutoGen is a standout in the Ship It category — giving your AI agent 6 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.tools.mcp import McpWorkbench
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with McpWorkbench(
server_params={"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"},
transport="streamable_http",
) as workbench:
tools = await workbench.list_tools()
agent = AssistantAgent(
name="portainer_agent",
tools=tools,
system_message=(
"You help users with Portainer. "
"6 tools available."
),
)
print(f"Agent ready with {len(tools)} tools")
asyncio.run(main())
* 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
About Portainer MCP Server
Connect your Portainer instance to any AI agent and orchestrate your containerized infrastructure through natural conversation.
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.
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.
The Portainer MCP Server exposes 6 tools through the Vinkius. Connect it to AutoGen in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 6 Portainer tools available for AutoGen
When AutoGen connects to Portainer through Vinkius, your AI agent gets direct access to every tool listed below — spanning docker, kubernetes, container-management, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Add endpoint on Portainer
Add a new environment (endpoint) to Portainer
Authenticate on Portainer
Authenticate to receive a JWT token
Create docker container on Portainer
Create a new Docker container
Init admin on Portainer
Initialize Portainer admin password
List docker containers on Portainer
List Docker containers in an environment
Start docker container on Portainer
Start a Docker container
Connect Portainer to AutoGen via MCP
Follow these steps to wire Portainer into AutoGen. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install AutoGen
pip install "autogen-ext[mcp]"Replace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenIntegrate into workflow
Explore tools
Why Use AutoGen with the Portainer MCP Server
AutoGen provides unique advantages when paired with Portainer through the Model Context Protocol.
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 + AutoGen Use Cases
Practical scenarios where AutoGen combined with the Portainer MCP Server delivers measurable value.
Collaborative analysis: one agent queries Portainer while another validates results and a third generates the final report
Automated review pipelines: a researcher agent fetches data from Portainer, a critic agent evaluates quality, and a writer produces the output
Interactive planning: agents negotiate task allocation using Portainer data to make informed decisions about resource distribution
Code generation with live data: an AutoGen coder agent writes scripts that process Portainer responses in a sandboxed execution environment
Example Prompts for Portainer in AutoGen
Ready-to-use prompts you can give your AutoGen agent to start working with Portainer immediately.
"List all containers in Portainer endpoint 1."
"Create a new container named 'web-server' using the 'nginx:latest' image in endpoint 2."
"Start the container 'redis-cache' in endpoint 1."
Troubleshooting Portainer MCP Server with AutoGen
Common issues when connecting Portainer to AutoGen through Vinkius, and how to resolve them.
McpWorkbench not found
pip install "autogen-ext[mcp]"Portainer + AutoGen FAQ
Common questions about integrating Portainer MCP Server with AutoGen.
How does AutoGen connect to MCP servers?
Can different agents have different MCP tool access?
Does AutoGen support human approval for tool calls?
Explore More MCP Servers
View all →
emfluence Marketing
10 toolsEquip your AI agent to manage marketing emails, track contact groups, and monitor performance via the emfluence API.

Swarm
5 toolsOrchestrate multi-agent AI workflows where specialized agents collaborate, delegate tasks, and solve complex problems together.

Documo
10 toolsEquip your AI agent to manage digital faxes, track fax numbers, and monitor transmissions via the Documo API.

AfterLogic Aurora
5 toolsEmail and webmail management — manage folders, messages, and accounts via AI.
