How to Use the Gitpod MCP in Windsurf

Q: How do I connect Gitpod to Windsurf Cascade?

Add the MCP Server to your /.codeium/windsurf/mcpconfig.json file or use the Cascade settings UI. Once saved, Cascade auto-discovers all 26 tools instantly.

Q: Can Windsurf Cascade manage multiple Gitpod organizations?

Yes. Cascade uses listorganizations to view your accounts and lets you switch between them to run administrative tools like getorganizationsettings.

Q: How does Windsurf handle Gitpod workspace timeouts?

Cascade can monitor your active environments and invoke stopworkspace when it detects you are done working. This prevents runaway cloud billing on idle resources.

Let Windsurf Cascade autonomously spin up, configure, and tear down Gitpod workspaces while you focus on writing code.

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 Windsurf

Create your Vinkius account to connect Gitpod to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Gitpod environments inside Windsurf

The Gitpod MCP Server gives Cascade direct control over your cloud dev environments. When you ask Cascade to start a new feature branch, it immediately calls `create_and_start_workspace` to build a clean sandbox. No manual context switching to a browser. Cascade doesn't just stop at creating environments. By tracking active sessions with `list_workspaces`, the agent shuts down idle projects using `stop_workspace` once your pull request goes green.

Autonomously manage repository configurations

This MCP integration allows Cascade to handle complex environment setups without asking for permission at every step. Configuring your development environment templates happens instantly by invoking `create_configuration` and injecting required credentials via `create_environment_variable`. If a repository setup changes, the agent updates the parameters using `update_configuration` to keep your workspace aligned with the main branch. Cascade verifies everything works by running its own internal tests directly inside the newly spawned container.

Govern organization access and team settings

You can direct Windsurf to audit and manage your team's cloud infrastructure directly from the chat interface. To audit who has access, Cascade runs `list_organization_members` and applies `update_organization_member` to adjust roles based on your instructions. For enterprise compliance, the agent executes `list_audit_logs` to scan for security anomalies. Detecting unauthorized access triggers `remove_organization_member` immediately to secure your organization's perimeter.

Setup guide

Set up Gitpod MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Gitpod MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Gitpod payment history." If connected, Cascade will call the Gitpod tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "gitpod-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

Add the MCP Server to your `~/.codeium/windsurf/mcp_config.json` file or use the Cascade settings UI. Once saved, Cascade auto-discovers all 26 tools instantly.

Yes. Cascade uses `list_organizations` to view your accounts and lets you switch between them to run administrative tools like `get_organization_settings`.

Cascade can monitor your active environments and invoke `stop_workspace` when it detects you are done working. This prevents runaway cloud billing on idle resources.

You can clean up old setups easily. Tell the agent to target a specific repository, and it will execute `delete_configuration` to remove it.

Your Gitpod API tokens and workspace states remain strictly within your local environment. This MCP Server processes requests through a secure V8 sandbox, meaning your private environment variables and repository configurations are never exposed to third-party 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