How to Use the Gitpod MCP in Mastra AI

Q: How do I register the Gitpod MCP Server tools inside a Mastra AI agent?

Initialize the client using @mastra/mcp and pass the Vinkius URL. Call mcpClient.listTools() and spread the returned tools directly into your Mastra agent configuration block.

Q: Can Mastra AI handle human approval before deleting a Gitpod workspace?

Yes, use the requireToolApproval setting in Mastra to pause the workflow. The agent will wait for your confirmation before executing deleteworkspace or deleteconfiguration.

Q: Can I run parallel Gitpod workspace checks across multiple organizations using Mastra AI?

Yes, you can write a workflow that queries listorganizations and runs parallel tasks to check workspace states. The framework manages the concurrent execution and aggregates the results for your agent.

Build resilient background agents that control Gitpod workspaces and configurations with Mastra AI and this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gitpod MCP to Mastra AI

Create your Vinkius account to connect Gitpod 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 Gitpod with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Gitpod workspace lifecycles with Mastra AI

This tool connects Mastra AI workflows to Gitpod's infrastructure to handle workspace failures and timeouts automatically. You can build a Mastra AI workflow that runs `create_and_start_workspace` and immediately checks the Gitpod status with `get_workspace`. If the Gitpod workspace fails to spin up, Mastra AI's engine triggers a retry branch to run `stop_workspace` and try a different region. The built-in Mastra AI workflow engine guarantees your developers never get stuck with hung Gitpod environments.

Sync Gitpod repository configurations with Mastra AI

Use `create_configuration` and `list_configurations` inside Mastra AI to audit and align Gitpod environment baselines across all developer teams. If a Gitpod configuration is missing, the Mastra AI agent automatically runs `create_environment_variable` to patch the gap. The Mastra AI framework handles Gitpod API rate limits by applying exponential backoff during bulk configuration operations. When managing dozens of Gitpod repositories, this Mastra AI MCP setup ensures updates complete without hitting API limits.

Standardize Gitpod organization settings with this MCP Server

Automate your Gitpod onboarding pipeline by calling `join_organization` and `update_organization_member` based on Mastra AI workflow events. Mastra AI processes these Gitpod steps sequentially, ensuring new hires get immediate access to their workspaces. If a developer leaves, the Mastra AI workflow executes `remove_organization_member` and sweeps active Gitpod environments using `delete_workspace`. This Mastra AI MCP workspace automation handles all Gitpod cleanup without manual checklist audits.

Setup guide

Set up Gitpod 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 Gitpod 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: "gitpod-mcp-client",
  servers: {
    "gitpod-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Gitpod 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 Gitpod. 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 Gitpod 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 Gitpod MCP in Mastra AI

Initialize the client using `@mastra/mcp` and pass the Vinkius URL. Call `mcpClient.listTools()` and spread the returned tools directly into your Mastra agent configuration block.

Yes, use the `requireToolApproval` setting in Mastra to pause the workflow. The agent will wait for your confirmation before executing `delete_workspace` or `delete_configuration`.

The workflow engine uses its built-in retry logic with exponential backoff. If `create_configuration` fails due to a temporary network blip, Mastra retries the call automatically before raising an error.

Yes, you can write a workflow that queries `list_organizations` and runs parallel tasks to check workspace states. The framework manages the concurrent execution and aggregates the results for your agent.

All workspace configurations and environment keys handled by `create_environment_variable` are transmitted directly to the Gitpod API via TLS. Vinkius processes these transactions in ephemeral sandboxes, meaning no repository configurations or credentials are ever stored on our servers.

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

Vercel AI SDK sdk-typescript