How to Use the UpCloud MCP in Mastra AI

Q: Does UpCloud support advanced networking with Mastra AI?

Absolutely. You'll use tools like createobjectstorage and listnetworks. The workflow engine ensures that all dependent network components are provisioned in the correct sequence.

Reliable Cloud Management Workflows for Mastra AI Agents. Handle Failures and Retries Natively.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect UpCloud MCP to Mastra AI

Create your Vinkius account to connect UpCloud to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup UpCloud with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Server Lifecycle with Reliability

Building a complex server setup needs guaranteed steps. Use the `create_server` tool to spin up hardware, then wrap it in logic that retries if the initial connection fails. You can also enforce rules using `create_firewall_rule`. If the primary server fails or gets decommissioned, your workflow can automatically execute `update_server` to modify settings or even call `delete_server` for clean cleanup.

Automate Disaster Recovery and Storage

Data loss is a huge headache. Your agent can define a recovery sequence: first, it calls `backup_storage`, then, if the subsequent restore attempt fails, it tries an alternate path using `clone_storage`. This ensures high availability. The workflow handles failures by attempting to `restore_storage` data from a backup before notifying the admin.

Provision Advanced Network Resources

Creating sophisticated network environments requires multiple steps. Start by calling `create_network`, and then ensure external access using `create_load_balancer`. The agent can also use `list_ips` to check for available addresses before assigning one via `assign_ip`. For full control, the workflow allows you to create specialized infrastructure like a Kubernetes cluster with `create_kubernetes_cluster`.

Setup guide

Set up UpCloud MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All UpCloud tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "upcloud-mcp-client",
  servers: {
    "upcloud-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "UpCloud Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to UpCloud tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent UpCloud transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by UpCloud. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect UpCloud now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about UpCloud MCP in Mastra AI

Mastra AI's built-in workflow engine is perfect here. You can set up conditional branching, for example: if `create_server` succeeds, proceed to networking; if it fails, retry the operation with a different zone.

Yes. The framework supports automatic retries and exponential backoff. This means your agent doesn't just fail on the first attempt to provision resources like `create_database`.

You can incorporate financial checks into your workflow using `get_billing_summary`. If the summary exceeds a defined threshold, the agent can trigger an alert or halt the deployment process.

Absolutely. You'll use tools like `create_object_storage` and `list_networks`. The workflow engine ensures that all dependent network components are provisioned in the correct sequence.

The server manages financial records, specifically allowing your agent to retrieve the monthly billing summary using `get_billing_summary`.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python