Portainer MCP Server for Mastra AIGive Mastra AI instant access to 6 tools to Add Endpoint, Authenticate, Create Docker Container, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Portainer through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Portainer MCP Server for Mastra AI 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
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"portainer": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Portainer Agent",
instructions:
"You help users interact with Portainer " +
"using 6 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Portainer?"
);
console.log(result.text);
}
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.
Mastra's agent abstraction provides a clean separation between LLM logic and Portainer tool infrastructure. Connect 6 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
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 Mastra AI 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 Mastra AI
When Mastra AI 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 Mastra AI via MCP
Follow these steps to wire Portainer into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Portainer MCP Server
Mastra AI provides unique advantages when paired with Portainer through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Portainer without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Portainer tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Portainer + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Portainer MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Portainer, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Portainer as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Portainer on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Portainer tools alongside other MCP servers
Example Prompts for Portainer in Mastra AI
Ready-to-use prompts you can give your Mastra AI 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 Mastra AI
Common issues when connecting Portainer to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpPortainer + Mastra AI FAQ
Common questions about integrating Portainer MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Envoy
10 toolsManage workplace operations via Envoy — register visitors, book desks and rooms, track deliveries, and monitor office capacity directly from any AI agent.
Customer.io
10 toolsEquip your AI agent to manage customer engagement, trigger automated campaigns, and track messaging metrics via the Customer.io API.
Airbrake
10 toolsCatch application errors in real time, track performance bottlenecks, and keep your codebase healthy with proactive monitoring.
Calendly Alternative
12 toolsManage meetings and scheduling via Calendly — list event types, track scheduled events, inspect invitees and manage webhooks from any AI agent.