Hetzner MCP Server for Mastra AIGive Mastra AI instant access to 38 tools to Create Certificate, Create Firewall, Create Floating Ip, and more
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Hetzner 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 Hetzner MCP Server for Mastra AI is a standout in the Developer Tools category — giving your AI agent 38 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import { 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: {
"hetzner": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Hetzner Agent",
instructions:
"You help users interact with Hetzner " +
"using 38 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Hetzner?"
);
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 Hetzner MCP Server
Connect your Hetzner Cloud account to any AI agent to orchestrate your infrastructure through natural language.
Mastra's agent abstraction provides a clean separation between LLM logic and Hetzner tool infrastructure. Connect 38 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
- Server Management — List all active servers, fetch specific details, and create or delete instances on demand.
- Power Control — Remotely power on servers or rebuild them from specific images using simple commands.
- Networking & Security — Manage private networks, configure firewalls, and handle floating IPs to ensure connectivity.
- Load Balancing — List and create load balancers to distribute traffic across your infrastructure efficiently.
The Hetzner MCP Server exposes 38 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 38 Hetzner tools available for Mastra AI
When Mastra AI connects to Hetzner through Vinkius, your AI agent gets direct access to every tool listed below — spanning cloud-hosting, server-management, infrastructure-as-code, 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.
Create certificate on Hetzner
Create a new certificate
Create firewall on Hetzner
Create a new firewall
Create floating ip on Hetzner
Create a new floating IP
Create load balancer on Hetzner
Create a new load balancer
Create network on Hetzner
Create a new network
Create server on Hetzner
Create a new server
Create ssh key on Hetzner
Create a new SSH key
Create storage box snapshot on Hetzner
Create a manual snapshot for a Storage Box
Create storage box subaccount on Hetzner
Create a subaccount for a Storage Box
Create volume on Hetzner
Create a new volume
Create zone on Hetzner
Create a new DNS zone
Delete load balancer on Hetzner
Delete a load balancer
Delete server on Hetzner
Delete a server
Get action on Hetzner
Get details of a specific action
Get server on Hetzner
Get details of a specific server
Get storage box on Hetzner
Get details of a specific Storage Box
List certificates on Hetzner
List all certificates
List datacenters on Hetzner
List all datacenters
List firewalls on Hetzner
List all firewalls
List floating ips on Hetzner
List all floating IPs
List images on Hetzner
List all images
List isos on Hetzner
List all ISOs
List load balancers on Hetzner
List all load balancers
List locations on Hetzner
List all locations
List networks on Hetzner
List all networks
List placement groups on Hetzner
List all placement groups
List primary ips on Hetzner
List all primary IPs
List server types on Hetzner
List all server types
List servers on Hetzner
List all servers
List ssh keys on Hetzner
List all SSH keys
List storage box snapshots on Hetzner
List snapshots for a Storage Box
List storage box subaccounts on Hetzner
List subaccounts for a Storage Box
List storage boxes on Hetzner
List all Storage Boxes
List volumes on Hetzner
List all volumes
List zones on Hetzner
List all DNS zones
Poweron server on Hetzner
Power on a server
Rebuild server on Hetzner
Rebuild a server from an image
Update storage box on Hetzner
Update Storage Box settings (e.g., enable/disable protocols like SMB, WebDAV)
Connect Hetzner to Mastra AI via MCP
Follow these steps to wire Hetzner 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 Hetzner MCP Server
Mastra AI provides unique advantages when paired with Hetzner through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Hetzner 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 Hetzner 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
Hetzner + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Hetzner MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Hetzner, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Hetzner as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Hetzner on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Hetzner tools alongside other MCP servers
Example Prompts for Hetzner in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Hetzner immediately.
"List all my active servers in the Hetzner Cloud."
"Get the full details for server ID 12345."
"Power on the server with ID 12347."
Troubleshooting Hetzner MCP Server with Mastra AI
Common issues when connecting Hetzner to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpHetzner + Mastra AI FAQ
Common questions about integrating Hetzner 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 →
Parseur
10 toolsAutomate document processing via Parseur — list mailboxes, upload PDFs/Emails, extract structured data pipelines, and trigger template logic natively.

SwaggerHub
10 toolsConnect your AI to SwaggerHub. Read OpenAPI specifications, explore domains, and manage your API design lifecycle natively from the terminal.

TomTom
10 toolsEquip your AI agent with global mapping, routing, and real-time traffic capabilities powered by TomTom.

Plaid Enterprise Banking
10 toolsUltimate Open Banking: balances, transactions, ML fraud logic, payroll, and asset verification.
