Skip to content

RPG Maker MV Ultimate MCP

AI agent toolkit to edit RPG Maker MV: maps, events, database, knowledge-driven map generation

build.protocol_tooling.mcp

Install RPG Maker MV Ultimate MCP in your MCP client

RPG Maker MV Ultimate MCP is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add RPG Maker MV Ultimate MCP to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; RPG Maker MV Ultimate MCP's tools should appear.
{
  "mcpServers": {
    "rpg-maker-mv-ultimate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "RPGMAKER_PROJECT_PATH": "<your-rpgmaker-project-path>",
        "VISION_API_URL": "<your-vision-api-url>",
        "VISION_API_KEY": "<your-vision-api-key>",
        "VISION_MODEL": "<your-vision-model>",
        "RPGMV_LEGACY_TOOLS": "<your-rpgmv-legacy-tools>"
      }
    }
  }
}

Install RPG Maker MV Ultimate MCP in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. RPG Maker MV Ultimate MCP will show up in the assistant's tool list on next launch.

Install RPG Maker MV Ultimate MCP in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). RPG Maker MV Ultimate MCP will show up in the assistant's tool list on next launch.

Install RPG Maker MV Ultimate MCP in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). RPG Maker MV Ultimate MCP will show up in the assistant's tool list on next launch.

Install RPG Maker MV Ultimate MCP in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. RPG Maker MV Ultimate MCP will show up in the assistant's tool list on next launch.

npm package: rpgmaker-mv-mcp

Required environment variables

RPG Maker MV Ultimate MCP needs the following environment variables set before it can run. Add them to the env block of your mcpServers entry, or export them in your shell before launching the client.

  • RPGMAKER_PROJECT_PATH
  • VISION_API_URL
  • VISION_API_KEY
  • VISION_MODEL
  • RPGMV_LEGACY_TOOLS

Transport

RPG Maker MV Ultimate MCP supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdio

Other Model Context Protocol servers in the same space as RPG Maker MV Ultimate MCP. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.