Integrate Portainer with Claude, Cursor, Chatbots & AI Agents MCP Server

Q: How do I see all containers running in a specific environment?

Use the listdockercontainers tool by providing the specific endpoint_id. The agent will return a list of all containers managed within that Portainer environment.

Manage Docker containers and environments via Portainer — list, create, and start containers directly from your AI agent.

GDPR Free for Subscribers

Compatible with every major AI agent and IDE

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

+ other MCP clients

add

Add endpoint on Portainer

Add a new environment (endpoint) to Portainer

action

Authenticate on Portainer

Authenticate to receive a JWT token

create

Create docker container on Portainer

Create a new Docker container

init

Init admin on Portainer

Initialize Portainer admin password

list

List docker containers on Portainer

List Docker containers in an environment

start

Start docker container on Portainer

Start a Docker container

Security & Code Integrity Audit

Every tool in the Portainer MCP Server is continuously audited by the Vinkius Security Engine. We guarantee zero-trust payload isolation, strict data boundaries, and deterministic execution for enterprise-grade AI agents.

A+Score: 100

How Vinkius protects your data

Can I audit what my AI agents are doing with this integration?

Yes, Vinkius provides an immutable, HMAC-chained audit log. Every tool execution, payload, and response is tracked in real-time on your dashboard, giving you complete visibility into your agent's actions.

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.

How does the AI access my passwords and credentials?

It simply doesn't. On Vinkius, your passwords, API keys, and login details are kept in a secure vault. The AI (like ChatGPT or Claude) merely "asks" Vinkius to perform the task. Vinkius opens the door, does the work, and hands the result back to the AI. Your credentials are never seen, read, or learned by the artificial intelligence.

What happens if the underlying API rate limits my agent?

Our edge infrastructure automatically handles backoffs, queueing, and throttling. If an AI agent sends too many erratic requests, Vinkius manages the rate limits gracefully, ensuring your backend doesn't crash.

What can AI Agents do with Portainer?

The Portainer integration provides structured, LLM-friendly schemas for reliable tool execution within your agentic workflows.

Next-Gen docker Operations

Provide Claude Code and Cursor with read and write access to docker. The Portainer toolkit handles all necessary routing for ship it integrations.

Prompting kubernetes Workflows

Add Portainer to your workspace to support kubernetes automation. The integration processes the required parameters for ship it execution by LLMs.