How to Use the WorkAdventure MCP in Windsurf

Q: How do I find out about WorkAdventure maps using Windsurf?

Just call the listmaps tool. This quickly shows all the available map names in your virtual world, so you know what spaces are ready for collaboration.

Q: If I need to track members in WorkAdventure with Windsurf, how do I start?

You'll use listmembers. This tool gives you a real-time list of every person currently registered as being in the virtual office. It’s perfect for auditing attendance.

Q: What if I want to change a variable in WorkAdventure using Windsurf?

Use the updateroomvariable tool. This lets you programmatically set or change data points within specific rooms, like changing a project status flag.

Q: Does the MCP Server support listing all active rooms in WorkAdventure with Windsurf?

Yep. The listrooms tool handles that. It gives you an immediate roster of every room currently open and operational in your virtual environment.

Manage virtual teams and collaboration spaces with Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect WorkAdventure MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Check Virtual World Status with WorkAdventure MCP Server

You can get a full picture of the virtual world using `get_world_info`. This tells you about the general state of your simulated office space. It also lets you see what maps exist by running `list_maps`, so Windsurf knows exactly where to look for resources.

Manage Users and Rooms with Windsurf

Need to know who's in the office? Use `list_members` to pull a list of everyone currently active. You can also check specific user info using `get_member_details`. If you need to adjust who's there, Cascade handles that with `create_member` or `delete_member`.

Read and Update Room Variables via MCP Server

Some rooms hold specific data—like a project status or meeting schedule. You grab this info using `get_room_variables`. This tool reads all the variables set for any given space. Furthermore, if someone changes the plan, you can update that variable directly with `update_room_variable`.

Setup guide

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

mcp_config.json

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

Just call the `list_maps` tool. This quickly shows all the available map names in your virtual world, so you know what spaces are ready for collaboration.

You'll use `list_members`. This tool gives you a real-time list of every person currently registered as being in the virtual office. It’s perfect for auditing attendance.

This MCP Server primarily deals with user and room state data, including member IDs and map details. You'll find functions like `get_member_details` to access individual user profiles.

Use the `update_room_variable` tool. This lets you programmatically set or change data points within specific rooms, like changing a project status flag.

Yep. The `list_rooms` tool handles that. It gives you an immediate roster of every room currently open and operational in your virtual environment.

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