How to Use the Robin MCP in Windsurf

Q: What happens if a Robin desk booking fails in Windsurf?

If reservedesk returns an error, Windsurf analyzes the Robin response. Cascade then checks listdesks for alternative workstations and asks if you want to book one of those instead.

Run Windsurf to book desks and coordinate meeting rooms directly through Cascade's multi-step autonomous planning.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Robin MCP to Windsurf

Create your Vinkius account to connect Robin to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Robin with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Auto-map office spaces in Windsurf

The `list_locations` tool pulls your physical office sites so Cascade can map where your team sits. Cascade chains this with `list_spaces` to find available rooms without making you run multiple manual searches. This MCP connection lets the agent parse the raw Robin JSON and suggest the best spots based on your current team size. You get a list of active meeting rooms for any date in your Windsurf editor.

Reserve desks with this MCP Server

The `reserve_desk` tool locks in a physical workstation inside Windsurf for your next office visit. Cascade handles the entire Robin sequence, checking your schedule, finding open desks using `list_desks`, and finalizing the reservation. If your plans change, Cascade runs `cancel_desk_reservation` in Windsurf to free up the space. You don't have to open a browser or click through a web portal while working in Windsurf to manage your Robin bookings.

Coordinate rooms via Cascade

The `book_space` tool creates a calendar event and secures your selected meeting room instantly inside Windsurf. Our integration checks room availability with `get_free_busy` before running the Robin booking command to prevent double-booking issues. Cascade reads your active Windsurf chat context to grab Robin meeting titles and times. It handles the API handshake and drops the Robin confirmation details right into your Windsurf editor panel.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "robin-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 Robin Workspace API. 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 Robin 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 Robin MCP in Windsurf

Windsurf connects to the Robin API through our managed interface. Cascade runs tools like `list_locations` and `reserve_desk` to handle your physical office bookings directly from your Windsurf workspace.

Yes, Cascade runs multi-step Robin operations autonomously in Windsurf. For example, it checks room schedules with `get_free_busy` and immediately runs `book_space` if the room is open.

If `reserve_desk` returns an error, Windsurf analyzes the Robin response. Cascade then checks `list_desks` for alternative workstations and asks if you want to book one of those instead.

No, Vinkius handles the credentials on our secure infrastructure. Your local Windsurf configuration file only needs a single endpoint token to access this Robin MCP Server.

Our MCP setup uses isolated V8 sandboxes to process your Robin desk reservations and meeting event details. We never store your physical office layout data or employee booking history from Windsurf 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