Log inSubmit server
GameWorld Painter MCP logo

GameWorld Painter MCP

Connects AI agents to an open GameWorld Painter map for inspection, analysis, and reviewed edits.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install GameWorld Painter MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "game-world-painter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "game-world-painter-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 28 tools correctly (Today).

Overview

GameWorld Painter Painter MCP MCP server connects supported AI clients to the GameWorld Painter browser app and its map files. It lets agents inspect maps, measure regions, analyze walkability and routes, and propose edits to terrain, layers, objects, and notes. The server uses Node.js 18+ and a local MCP process, while the app reads and writes the project folder. Reach for it when an agent needs to work on a layered game-world map rather than only edit standalone files.

Use cases

  • Inspect a game map and summarize its regions
  • Scatter objects with spacing constraints
  • Find blocked routes and repair terrain issues
  • Create or modify map layers through an AI agent
  • Review proposed bridges, buildings, and terrain edits

Key features

  • Reads map overviews, images, regions, objects, and routes
  • Analyzes walkability, spacing, crossings, and overlaps
  • Edits terrain, masks, categories, objects, and layers
  • Supports reviewable before-and-after map changes
  • Opens or creates maps by filesystem path
  • Works with PNG and JSON project folders

Tools28

What GameWorld Painter MCP lets your agent do. Expand a tool for its parameters.

Verified live~8.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

What it can do

From the 28 tools this server returned when we ran it; 28 declare their own safety hints.

Can delete or modify data · 2Read-only tools · 26
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age14 days
Maintainers1

Observed 2026-10-23 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · game-world-painter-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1kPackage downloads in the last 30 days.
Last commit14d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed28Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How GameWorld Painter MCP works

What GameWorld Painter MCP does

GameWorld Painter MCP MCP server gives AI agents an interface to a map open in the GameWorld Painter web application. GameWorld Painter is a top-down world editor whose projects are folders containing PNG and JSON data. The server lets an agent inspect that data through the app, reason about selected or named regions, and make changes that can be reviewed in the map UI.

The supported map model includes terrain height, mask and category layers, placed objects, notes, and vector features such as roads or rivers. Agents can request map overviews, grid images, regional facts, object lists with distances, open or hidden areas, walkability, routes, spacing, and groups. They can also work with regions such as a selected area, a zone, space around roads, or intersections.

How it works

The MCP package runs locally with Node.js 18 or newer and has no dependencies according to the project documentation. An MCP-compatible client starts the server, while GameWorld Painter remains open in Chrome or Edge on the desktop. The server can open an existing map by path or create a new one; it can also open the app in the browser when needed.

Changes are presented to the agent with before-and-after images and outlined objects. GameWorld Painter can check proposed work for conditions such as overlaps, objects placed in water or on roads, uneven terrain, and bridge endpoints. Review mode is enabled by default in the app, so an agent’s edits become proposals that a user can accept, modify with a comment, or reject. Each accepted change is one undo step.

The application watches the project folder and normally reflects external changes within about a second. The folder remains the source of truth, making the map usable by build scripts, importers, notebooks, or other tools that read PNG and JSON.

Setup and configuration

Install the package through an MCP client using the command shown in the project documentation:

Terminal
npx -y game-world-painter-mcp

The repository also provides a setup command that prints configuration commands for supported agents:

Terminal
npx -y game-world-painter-mcp setup

Open GameWorld Painter at its hosted web address in Chrome or Edge, create or open a project folder, and enable the AI Agent control in the app header. The status indicator shows when an agent is connected. The app requires the File System Access API, which Firefox and Safari do not provide for this workflow.

Tools and capabilities

GameWorld Painter MCP MCP server supports agent operations for:

  • Reading map overviews, rendered images, measurements, regional facts, objects, routes, walkability, spacing, and groups.
  • Finding suitable locations and crossings, including bridge crossings with land at both ends.
  • Scattering objects, adding or editing items, deleting items, and creating layers.
  • Painting masks and categories with soft edges or noise.
  • Raising, lowering, flattening, smoothing, and sloping terrain.
  • Getting the project path for scripts and other file-based workflows.
  • Opening maps or creating new maps from a filesystem path.

The agent can act on the current selection or on meaningful map regions. Object edits include properties and placement, while the app’s underlying files preserve terrain, layer, object, vector, and note data.

Limitations and notes

The tool operates on the map open in GameWorld Painter rather than providing a standalone game-engine editor. The browser application must be run on a compatible desktop browser, and its file access permission must be granted for the project folder. The 3D preview uses WebGL2 when available and falls back to a simpler software view when it is not.

GameWorld Painter MCP MCP server is intended for the 🎮 Gaming category and is most relevant when an agent needs spatial context, visual review, or batch changes across a layered game-world plan.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about GameWorld Painter MCP

GameWorld Painter MCP is an MCP server that connects AI agents to the GameWorld Painter browser app and its map project folder. Its main tools inspect maps, measure regions, analyze routes and walkability, and propose edits to terrain, layers, objects, and notes for review in the app.

Install it through an MCP client with `npx -y game-world-painter-mcp`. The package requires Node.js 18 or newer, and `npx -y game-world-painter-mcp setup` prints setup commands for supported agents.

Yes, GameWorld Painter MCP is documented for Cursor. Add the local MCP command to Cursor, open a map in GameWorld Painter, and enable AI Agent mode in the app so the client can connect.

Chrome and Edge on desktop support the required GameWorld Painter workflow. The app uses the File System Access API to read and write the project folder; the documentation says Firefox and Safari do not support it.

Yes, the app’s review mode is enabled by default. Proposed changes appear with before-and-after images, outlined objects, an explanation, and per-step comments, allowing the user to accept, change, or reject them.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGameWorld Painter MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/game-world-painter-mcp?style=directory)](https://allmcps.com/mcp/game-world-painter-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/game-world-painter-mcp"><img src="https://allmcps.com/api/badge/game-world-painter-mcp?style=directory" alt="GameWorld Painter MCP on AllMCPs" /></a>