Provides tools for interacting with Portainer API, enabling management of Docker containers, stacks, environments, and other resources through the Portainer platform.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@portainer-mcp list all my Docker containers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Deploy portainer-mcp via npx — no manual download, no PM2, just works across platforms.
This package is also a wrapper that auto-downloads the correct binary for your platform (Linux, macOS, Windows) on install.
npx @lauredmarin/portainer-mcp -server https://portainer.example.com -token YOUR_TOKEN{
"mcpServers": {
"portainer": {
"type": "stdio",
"command": "npx",
"args": [
"--package=@lauredmarin/portainer-mcp",
"portainer-mcp",
"-server", "https://portainer.example.com",
"-token", "YOUR_TOKEN"
]
}
}
}npm install -g @lauredmarin/portainer-mcp
portainer-mcp -server https://portainer.example.com -token YOUR_TOKENRelated MCP server: Docker MCP Server
For exposing as HTTP endpoint on a VPS:
Linux x86-64 (amd64)
curl, tar
Node.js + npm (for PM2)
uv (installed automatically by install.sh if missing)
git clone https://github.com/Lauredmarin/portainer-mcp-amd64.git
cd portainer-mcp-amd64
bash install.sh
cp .env.example .env # fill in your values
pm2 start ecosystem.config.js
pm2 save && pm2 startup.env)Variable | Required | Default | Description |
| ✅ | — | Portainer URL (e.g. |
| ✅ | — | Portainer API token |
| ❌ |
| Port exposed by mcp-proxy |
| ❌ |
| Path to binary |
| ❌ | — | Path to a tools.yaml to restrict tools |
Once running, the server is available at:
http://<your-vps-ip>:<MCP_PORT>/mcpMCP client config:
{
"mcpServers": {
"portainer": {
"type": "http",
"url": "http://<your-vps-ip>:8749/mcp"
}
}
}Platform | Architecture | Status |
Linux | amd64, arm64, arm | ✅ |
macOS | amd64 (Intel), arm64 (Apple Silicon) | ✅ |
Windows | amd64, arm64 | ✅ |
git clone https://github.com/Lauredmarin/portainer-mcp-amd64.git
cd portainer-mcp-amd64
npm install
npm run postinstall # Downloads binary
node run.js -helpOriginal portainer-mcp: https://github.com/portainer/portainer-mcp
NPM Package: https://www.npmjs.com/package/@lauredmarin/portainer-mcp (when published)
Issues: https://github.com/Lauredmarin/portainer-mcp-amd64/issues
MIT
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Create and manage AI agents that collaborate and solve problems through natural language interacti…
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lauredmarin/portainer-mcp-amd64'
If you have feedback or need assistance with the MCP directory API, please join our Discord server