How to Use the WorkAdventure MCP in Cursor

Q: How do I get a list of members in WorkAdventure with Cursor?

Just call the listmembers tool. The live API response gives you an array of member objects, ready to be destructured and used inside your active function.

Q: What kind of data can I use for WorkAdventure with Cursor?

You can access roomvariables and general world info via getworldinfo. This means you're working with real operational data, not mock stubs.

Q: Can I track room changes for WorkAdventure using Cursor?

Yes. You can use listrooms to get all current rooms, and then loop through them calling getroomvariables on each one to check the status.

Q: How do I list all available maps for WorkAdventure with Cursor?

Run the listmaps tool. It provides a clean, consumable array of map names that you can iterate over right in your code editor.

Inject real WorkAdventure data into your code using Cursor.

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 Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

WorkAdventure for Code Context

Start by calling `list_members` to generate a list of all current members. You can then use this array directly in your generated TypeScript or Python functions. Need more data? Use `get_world_info`. This provides global parameters you can write into your code base without leaving the editor.

Managing Virtual Office State

The toolset lets you handle room state variables. Write a function that calls `update_room_variable` to change a project status flag, then use that returned value immediately in your subsequent code block. You can also read the current state using `get_room_variables`, which feeds live data into your coding context.

Listing and Manipulating World Spaces

To build out a client that knows about the virtual office, start with `list_maps`. This gets all available map names. You can then use `get_map_details` to pull specific structural data into your application logic. When you're done, remember `list_rooms` helps you iterate over every active meeting point.

Setup guide

Set up WorkAdventure MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the WorkAdventure MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent WorkAdventure transactions." If the MCP tools are loaded correctly, Cursor will call the WorkAdventure tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

Just call the `list_members` tool. The live API response gives you an array of member objects, ready to be destructured and used inside your active function.

You can access `room_variables` and general world info via `get_world_info`. This means you're working with real operational data, not mock stubs.

Yes. You can use `list_rooms` to get all current rooms, and then loop through them calling `get_room_variables` on each one to check the status.

This server touches room variables. Specifically, you can read and update any key-value pair using `get_room_variables` or `update_room_variable`.

Run the `list_maps` tool. It provides a clean, consumable array of map names that you can iterate over right in your code editor.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.