• MAP DATA
  • ROOM LISTS
  • METADATA
  • HUMAN

How to audit virtual world configuration with your AI

Connect your AI to WorkAdventure to pull real-time environment data. Once connected, your agent can scan your maps and rooms to find configuration gaps.

Ask AI about this page

Short answer

How can I audit my WorkAdventure world with AI?

Your AI uses the WorkAdventure MCP to fetch map details, room lists, and world metadata. You can then ask your agent to spot missing rooms or verify that specific maps are correctly configured. This gives you a clear view of your virtual environment's structure.

Audit outcomes

Where your audit data lands

The AI processes your environment data into these specific categories.

MAP DATA

Map integrity checks

The AI pulls specific map details to ensure assets and settings match your requirements. You get a clear report on map-level configurations.

ROOM LISTS

Room presence verification

Your agent lists every room in the world to confirm nothing is missing. This helps you catch broken links or unmapped areas.

METADATA

World info summary

The AI retrieves high-level world metadata to provide a snapshot of the entire environment. Use this to verify global settings.

HUMAN

Manual fixes needed

The AI identifies discrepancies but cannot change the map files or room settings. You'll need to jump into the editor to apply any corrections.

The workflow

What your AI does when the request arrives.

The AI moves through your WorkAdventure data to build a complete picture of your virtual space.

  1. Fetch world context

    The agent starts by pulling the high-level configuration and metadata for the entire virtual space.

    get_world_info

  2. Inventory all maps

    It scans the environment to find every available map currently active in the world.

    list_maps

  3. Inspect map settings

    The AI looks into the specific properties and configurations of a single map to check for errors.

    get_map_details

  4. Verify room layout

    It pulls a list of all rooms within a map to ensure the spatial structure is correct.

    list_rooms

Try it

Copy these to start.

Use these prompts to begin your audit.

Starting points

These are starting points. Swap out the specific map names or room IDs with your own data.

WorkAdventure Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_6yEP7dJTIiacSjZM4wf282iVcNImfn8oPePYfEym/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — WorkAdventure capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "workadventure-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_6yEP7dJTIiacSjZM4wf282iVcNImfn8oPePYfEym/mcp"
    }
  }
}
Copy into chat04

  • List all the maps in my WorkAdventure world and tell me if any look incomplete.

  • Get the details for the 'Main Office' map and check if the configuration is valid.

  • Show me a list of all rooms in the 'Conference Center' map.

  • Summarize the world metadata to help me understand my current environment setup.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect WorkAdventure once, then ask.

Just follow the link to connect your account. Your credentials stay encrypted, and you can immediately start asking your AI about your maps.

Connect WorkAdventure to your AI

FAQ

How the audit behaves

  • 01

    Can the AI fix a broken map?

    No. The AI can only read and report on the configuration. You have to make any actual changes in the WorkAdventure editor yourself.

  • 02

    Can the AI delete rooms?

    No. This MCP only provides read access to your world data. It cannot modify, add, or delete any part of your environment.

  • 03

    Does the AI see my private user data?

    No. The AI only accesses the world metadata, maps, and room lists provided by the tools.

  • 04

    How does the AI know which map I'm talking about?

    You should name the specific map in your prompt. The AI will then use the map list to find the right one.

  • 05

    Can I use this with any AI client?

    Yes, as long as your client is MCP-compatible, like Claude, Cursor, or Windsurf.

  • More questions about WorkAdventure? The Connector page answers them. See everything the WorkAdventure Connector can do

Connect WorkAdventure to Claude, Cursor, ChatGPT & more