Gitpod MCP Server for WindsurfGive Windsurf instant access to 26 tools to Create And Start Workspace, Create Configuration, Create Environment Variable, and more
Windsurf brings agentic AI coding to a purpose-built IDE. Connect Gitpod through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
Ask AI about this MCP Server for Windsurf
The Gitpod MCP Server for Windsurf 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
{
"mcpServers": {
"gitpod": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install Gitpod and 4,000+ MCP Servers from a single visual interface.





* 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.
Windsurf's Cascade agent chains multiple Gitpod tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 26 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
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 Windsurf 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 Windsurf
When Windsurf 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 Windsurf via MCP
Follow these steps to wire Gitpod into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Open MCP Settings
Cmd+Shift+P and search "MCP"Add the server
mcp_config.jsonSave and reload
Start using Gitpod
Why Use Windsurf with the Gitpod MCP Server
Windsurf provides unique advantages when paired with Gitpod through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 26 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Gitpod + Windsurf Use Cases
Practical scenarios where Windsurf combined with the Gitpod MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from Gitpod and generate models, types, or handlers based on real API responses
Live debugging: query Gitpod tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from Gitpod and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine Gitpod data with Cascade's code generation to scaffold entire features in minutes
Example Prompts for Gitpod in Windsurf
Ready-to-use prompts you can give your Windsurf 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 Windsurf
Common issues when connecting Gitpod to Windsurf through Vinkius, and how to resolve them.
Server not connecting
Gitpod + Windsurf FAQ
Common questions about integrating Gitpod MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Explore More MCP Servers
View all →
Bidsketch
10 toolsAutomate proposal creation via Bidsketch — list proposals, clients, and templates directly from any AI agent.

Better Stack
10 toolsMonitor uptime and incidents via Better Stack — list monitors, heartbeats, and on-call schedules directly from any AI agent.

Sinch
10 toolsEnable your AI agent to send SMS messages, monitor delivery reports, and manage contact groups via the Sinch API.

Bland AI
12 toolsDeploy AI phone agents that handle inbound and outbound calls with natural conversation for sales and customer support.
