Gitpod MCP Server for Mastra AIGive Mastra AI instant access to 26 tools to Create And Start Workspace, Create Configuration, Create Environment Variable, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Gitpod 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 Gitpod MCP Server for Mastra AI is a standout in the Loved By Devs category — giving your AI agent 26 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: {
"gitpod": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Gitpod Agent",
instructions:
"You help users interact with Gitpod " +
"using 26 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Gitpod?"
);
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 Gitpod MCP Server
Connect your Gitpod account to any AI agent to orchestrate your cloud development lifecycle through natural language.
Mastra's agent abstraction provides a clean separation between LLM logic and Gitpod tool infrastructure. Connect 26 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
- Workspace Lifecycle — Create, start, stop, and delete workspaces using repository URLs or specific context IDs.
- Organization Management — List, create, and inspect organizations and their members to manage team access.
- Configuration & Env Vars — Manage workspace configurations and environment variables for consistent development setups.
- Audit & Sessions — Track workspace sessions and audit logs to monitor activity within your organizations.
The Gitpod MCP Server exposes 26 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 26 Gitpod tools available for Mastra AI
When Mastra AI connects to Gitpod through Vinkius, your AI agent gets direct access to every tool listed below — spanning cloud-ide, development-environments, automation, 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 and start workspace on Gitpod
Create and start a new Gitpod workspace
Create configuration on Gitpod
Create a new repository configuration in Gitpod
Create environment variable on Gitpod
Create an environment variable for a repository configuration
Create organization on Gitpod
Create a new Gitpod organization
Delete configuration on Gitpod
Delete a repository configuration
Delete environment variable on Gitpod
Delete an environment variable
Delete organization on Gitpod
Delete a Gitpod organization
Delete workspace on Gitpod
Delete a Gitpod workspace
Get configuration on Gitpod
Get details for a specific repository configuration
Get organization on Gitpod
Get details for a specific Gitpod organization
Get organization settings on Gitpod
Get settings for a Gitpod organization
Get workspace on Gitpod
Get details for a specific Gitpod workspace
Join organization on Gitpod
Join a Gitpod organization using an invitation ID
List audit logs on Gitpod
List audit logs for an organization (Enterprise Only)
List configurations on Gitpod
List repository configurations in an organization
List environment variables on Gitpod
List environment variables for a repository configuration
List organization members on Gitpod
List members of a Gitpod organization
List organizations on Gitpod
List all Gitpod organizations for the authenticated user
List workspace sessions on Gitpod
List workspace sessions (start/stop events) in an organization
List workspaces on Gitpod
List workspaces in an organization
Remove organization member on Gitpod
Remove a member from a Gitpod organization
Start workspace on Gitpod
Start an existing Gitpod workspace
Stop workspace on Gitpod
Stop a running Gitpod workspace
Update configuration on Gitpod
Update a repository configuration
Update organization member on Gitpod
Update a member role in a Gitpod organization
Update organization settings on Gitpod
Update settings for a Gitpod organization
Connect Gitpod to Mastra AI via MCP
Follow these steps to wire Gitpod 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 Gitpod MCP Server
Mastra AI provides unique advantages when paired with Gitpod through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Gitpod 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 Gitpod 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
Gitpod + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Gitpod MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Gitpod, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Gitpod as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Gitpod on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Gitpod tools alongside other MCP servers
Example Prompts for Gitpod in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Gitpod immediately.
"List all my Gitpod organizations."
"Create and start a workspace for https://github.com/gitpod-io/gitpod."
"Stop the workspace with ID 'ws-abc-123'."
Troubleshooting Gitpod MCP Server with Mastra AI
Common issues when connecting Gitpod to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpGitpod + Mastra AI FAQ
Common questions about integrating Gitpod 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 →
openFDA
3 toolsAccess the powerful openFDA databases for drug adverse events, food recalls, and medical device safety reports globally.
Kissflow
9 toolsBuild low-code workflows, process apps, and case management solutions that digitize operations without heavy IT involvement.
RocketLaunch.Live
9 toolsTrack rocket launches worldwide — search upcoming launches, vehicles, companies, locations and missions.
Thinkific
10 toolsCreate and sell online courses with a platform that handles course hosting, student enrollment, and payment processing beautifully.