How to Use the WorkAdventure MCP in OpenAI Agents SDK

Q: Can I check member details in WorkAdventure using OpenAI Agents SDK?

Yep. You call getmemberdetails with a specific ID to retrieve that person's full profile. This is key for knowing who you’re trying to collaborate with inside WorkAdventure.

Q: If I change the map in WorkAdventure, does OpenAI Agents SDK know?

Yes. You can list all available maps using listmaps. The agent uses this data before deciding which virtual location is appropriate for its next action within WorkAdventure.

Q: What happens if I mess up the room context in WorkAdventure?

You can fix that by calling updateroomvariable to explicitly set the correct variables. This ensures the agent always has accurate, current context for its decisions within WorkAdventure.

Manage complex virtual workspaces for remote teams using your OpenAI Agents SDK.

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 OpenAI Agents SDK

Create your Vinkius account to connect WorkAdventure to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Managing World State via MCP Server

You use `get_world_info` to pull the current state of the entire WorkAdventure environment. This tells your agent everything it needs to know about active rooms, members, and overall connectivity. It also lets you check out all available maps with `list_maps`. Knowing this data lets your specialized agents decide which virtual space makes sense for the next step.

Controlling Virtual Participants

Need to add someone to the office? The `create_member` tool handles that, adding a new person's presence to the world. You can also remove them with `delete_member`, cleaning up when they leave the virtual space. Furthermore, if you just need to know who’s there, `list_members` gets a full roster of everyone currently logged into WorkAdventure.

Updating Collaborative Room Variables

Sometimes a room needs state data—like setting the meeting objective or updating capacity. The `update_room_variable` tool changes specific variables within an active room. It’s also useful to grab existing variables using `get_room_variables`. This keeps your agent informed about what context is already established in that particular part of the virtual world.

Setup guide

Set up WorkAdventure MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all WorkAdventure tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives WorkAdventure tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate WorkAdventure tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="WorkAdventure Agent",
            instructions="You have access to WorkAdventure tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Your agents interact with WorkAdventure by treating it as a data source. You pass the MCP Server to your agent constructor, and it automatically discovers tools like `list_maps`. The agent then calls these functions when needed.

Yep. You call `get_member_details` with a specific ID to retrieve that person's full profile. This is key for knowing who you’re trying to collaborate with inside WorkAdventure.

Yes. You can list all available maps using `list_maps`. The agent uses this data before deciding which virtual location is appropriate for its next action within WorkAdventure.

You can fix that by calling `update_room_variable` to explicitly set the correct variables. This ensures the agent always has accurate, current context for its decisions within WorkAdventure.

This server exposes various forms of world state and user profiles, including map details, member lists, and specific room variables. The agent can access all the operational context provided by these functions.

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