Open Wilds Studio MCP Server

MCP server for Open Wilds Studio workspaces, asset generation, terrain assets, plant and object sprites, and saved maps.

Use With An MCP Client

{
  "mcpServers": {
    "open-wilds-studio": {
      "command": "npx",
      "args": ["-y", "@open-wilds/studio-mcp"],
      "env": {
        "OPEN_WILDS_STUDIO_CONVEX_URL": "https://first-warthog-31.convex.cloud"
      }
    }
  }
}

Authentication uses Convex Auth:

• Call the studio_sign_in MCP tool with a Studio email/password account.
• Or launch with OPEN_WILDS_STUDIO_AUTH_TOKEN=<convex-jwt>.

The server never bypasses Studio workspace permissions. Convex still enforces viewer, editor, admin, and owner role checks.

Local Development

npm install
npm run verify

The server reads .env.local from the current working directory, or use OPEN_WILDS_STUDIO_CONVEX_URL directly.

Relative file paths passed to upload/register tools resolve from the client's current working directory. Set OPEN_WILDS_STUDIO_MCP_ROOT to choose a different root. Absolute paths are rejected unless OPEN_WILDS_STUDIO_MCP_ALLOW_ABSOLUTE_PATHS=1 is set.

Tool Surface

• Auth tools: status, sign in, sign out.
• Workspace tools: create/list/get, roles, members, invites.
• Texture tools: generate/list/register source textures.
• Terrain tools: build/register/list terrain assets and end-to-end texture-to-terrain generation.
• Plant tools: generate/register/list plant and tree sprites.
• Object tools: generate/register/list object and building sprites.
• World tools: save and list Studio maps.