How to Use the E2B MCP in Windsurf

Run untrusted code safely inside Windsurf with E2B sandboxes that boot in 150ms.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect E2B MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Instant isolation for Windsurf agents

The `create_sandbox` tool lets your agent spin up a fresh Linux environment in milliseconds. It keeps your local machine clean by offloading execution to a Firecracker microVM. Windsurf can pick the right template for the job. Whether you need Python or Node, the environment is ready before you finish typing your next instruction.

Manage active environments

Use `list_sandboxes` to see exactly what is running in your account. It gives you a clear view of your active compute resources without leaving your IDE. This visibility helps you track which tasks are still in progress. You can audit your usage and ensure no resources sit idle.

Cleanup after execution

Call `kill_sandbox` once your task finishes. This wipes the filesystem and terminates the microVM permanently. It ensures you don't leave junk files behind. Your workspace stays organized because every session is ephemeral and self-contained.

Setup guide

Set up E2B 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 E2B 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 E2B payment history." If connected, Cascade will call the E2B tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "e2b-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 E2B. 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 E2B 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 E2B MCP in Windsurf

Open your MCP settings in Windsurf and add the server configuration. Once saved, Windsurf automatically detects the tools and makes them available to Cascade.

Yes, each sandbox uses Firecracker microVMs to isolate your processes. This keeps your local filesystem and network safe from any code your agent runs.

Sandboxes have a default timeout of 300 seconds to prevent resource leakage. If your task takes longer, you will need to start a new environment.

Yes, you can specify templates like python3 or node during the creation step. This ensures your environment has the right dependencies pre-installed.

No, data inside the sandbox is deleted when you call the termination tool. You should move any results you need to keep back to your local machine before ending the session.

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