4,000+ servers built on vurb.ts
Vinkius

Hetzner MCP Server for Mastra AIGive Mastra AI instant access to 38 tools to Create Certificate, Create Firewall, Create Floating Ip, and more

MCP Inspector GDPR Free for Subscribers

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.

Built for AI Agents by Vinkius

Vinkius delivers Streamable HTTP and SSE to any MCP client

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
typescript
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();
Hetzner
Fully ManagedVinkius Servers
60%Token savings
High SecurityEnterprise-grade
IAMAccess control
EU AI ActCompliant
DLPData protection
V8 IsolateSandboxed
Ed25519Audit chain
<40msKill switch
Stream every event to Splunk, Datadog, or your own webhook in real-time

* 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

Create certificate on Hetzner

Create a new certificate

create

Create firewall on Hetzner

Create a new firewall

create

Create floating ip on Hetzner

Create a new floating IP

create

Create load balancer on Hetzner

Create a new load balancer

create

Create network on Hetzner

Create a new network

create

Create server on Hetzner

Create a new server

create

Create ssh key on Hetzner

Create a new SSH key

create

Create storage box snapshot on Hetzner

Create a manual snapshot for a Storage Box

create

Create storage box subaccount on Hetzner

Create a subaccount for a Storage Box

create

Create volume on Hetzner

Create a new volume

create

Create zone on Hetzner

Create a new DNS zone

delete

Delete load balancer on Hetzner

Delete a load balancer

delete

Delete server on Hetzner

Delete a server

get

Get action on Hetzner

Get details of a specific action

get

Get server on Hetzner

Get details of a specific server

get

Get storage box on Hetzner

Get details of a specific Storage Box

list

List certificates on Hetzner

List all certificates

list

List datacenters on Hetzner

List all datacenters

list

List firewalls on Hetzner

List all firewalls

list

List floating ips on Hetzner

List all floating IPs

list

List images on Hetzner

List all images

list

List isos on Hetzner

List all ISOs

list

List load balancers on Hetzner

List all load balancers

list

List locations on Hetzner

List all locations

list

List networks on Hetzner

List all networks

list

List placement groups on Hetzner

List all placement groups

list

List primary ips on Hetzner

List all primary IPs

list

List server types on Hetzner

List all server types

list

List servers on Hetzner

List all servers

list

List ssh keys on Hetzner

List all SSH keys

list

List storage box snapshots on Hetzner

List snapshots for a Storage Box

list

List storage box subaccounts on Hetzner

List subaccounts for a Storage Box

list

List storage boxes on Hetzner

List all Storage Boxes

list

List volumes on Hetzner

List all volumes

list

List zones on Hetzner

List all DNS zones

poweron

Poweron server on Hetzner

Power on a server

rebuild

Rebuild server on Hetzner

Rebuild a server from an image

update

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.

01

Install dependencies

Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
02

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token
03

Run the agent

Save to agent.ts and run with npx tsx agent.ts
04

Explore tools

Mastra discovers 38 tools from Hetzner via MCP

Why Use Mastra AI with the Hetzner MCP Server

Mastra AI provides unique advantages when paired with Hetzner through the Model Context Protocol.

01

Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Hetzner without touching business code

02

Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation

03

TypeScript-native: full type inference for every Hetzner tool response with IDE autocomplete and compile-time checks

04

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.

01

Automated workflows: build multi-step agents that query Hetzner, process results, and trigger downstream actions in a typed pipeline

02

SaaS integrations: embed Hetzner as a first-class tool in your product's AI features with Mastra's clean agent API

03

Background jobs: schedule Mastra agents to query Hetzner on a cron and store results in your database automatically

04

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.

01

"List all my active servers in the Hetzner Cloud."

02

"Get the full details for server ID 12345."

03

"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.

01

createMCPClient not exported

Install: npm install @mastra/mcp

Hetzner + Mastra AI FAQ

Common questions about integrating Hetzner MCP Server with Mastra AI.

01

How does Mastra AI connect to MCP servers?

Create an MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.
02

Can Mastra agents use tools from multiple servers?

Yes. Pass multiple MCP clients to the agent constructor. Mastra merges all tool schemas and the agent can call any tool from any server.
03

Does Mastra support workflow orchestration?

Yes. Mastra has a built-in workflow engine that lets you chain MCP tool calls with branching logic, error handling, and parallel execution.

Explore More MCP Servers

View all →