game-world-painter-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y game-world-painter-mcp@0.3.1
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
5 tools that take no input and look read-only were called once with nothing. 0 returned a result.
get_map_info | No usable answer tool reported an error: GameWorld Painter is not connected to this MCP server. Ask the user to open the app (https://aleserb.github.io/game-world-painter/ or a |
get_user_context | No usable answer tool reported an error: GameWorld Painter is not connected to this MCP server. Ask the user to open the app (https://aleserb.github.io/game-world-painter/ or a |
get_project_path | No usable answer tool reported an error: GameWorld Painter is not connected to this MCP server. Ask the user to open the app (https://aleserb.github.io/game-world-painter/ or a |
find_items | No usable answer tool reported an error: GameWorld Painter is not connected to this MCP server. Ask the user to open the app (https://aleserb.github.io/game-world-painter/ or a |
find_crossing | No usable answer tool reported an error: GameWorld Painter is not connected to this MCP server. Ask the user to open the app (https://aleserb.github.io/game-world-painter/ or a |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
get_map_info
Start here. The open map: title, unit, bounds, cell size, every layer with what it holds (mask coverage, categories classes and their shares, height range, object kinds and property keys, notes, vector paths), the zones, conventions, and what the user is looking at. Coordinates: x grows east, z grows south, north is up.
open_map path, browser
Opens the map in the folder at "path" (the folder with metadata.json) in GameWorld Painter. The app then reads and writes that folder through this MCP server, without the user picking it. When no app is connected, the server opens it in the default browser with a link that connects it and opens the map (the user may have to allow Chrome to reach this device). The map open before is saved first.
create_map path, title, unit, width, height, cell, center, layers, browser
Creates a new map in the folder at "path" (made if missing; it must not have a map yet) and opens it in the app: the bounds and cell size in the unit of the map, and a set of layers — "basic" (terrain height, ground, zones, water, roads, rivers, borders, rocks, grass, bushes, trees, buildings, enemies, chests, hiding spots, notes), "none" (no layers: make them with create_layer), "notes" (only notes), or "same" (the layers of the map open now, empty). Then shape it with the other tools.
get_user_context
What the user is pointing at now: the selected area (its bounds and size), the selected items (their layer, kinds, ids), the selected layers, the active layer and tool, the view, the cursor, and what became of your latest changes. The user selects objects with Select (click, box) or the Select area tools (rectangle, ellipse, lasso, polygon, same kind) to show you what they mean. Use it for requests like "this area", "here", "these", "the selected ones".
get_project_path path
The full path of the project folder open in the app on this computer (the folder with metadata.json and layers/), the path of every layer file, and what the app has not saved yet. Use it to read or change the files with other tools (scripts, image tools, exporters). The browser does not reveal paths, so the server finds the folder — in your workspace, your working directory, then the home folder — and checks it is the same one (its metadata.json). If it is not found, ask the user for the path and pass it as "path".
23 more tools
render_map region, layers, size, grid, labels, highlight, format
An image of the map from above (north up) with a coordinate grid: the whole map, the view, or a region. Look before and after changes. Optional highlight of a region.
describe_region region, list_items
Everything in a region: its size and bounds, mask coverage, categories shares (zones, ground), heights and slopes, and the items of every layer by kind. Use it to check an area before and after changing it.
read_layer layer, region, resolution
The values of a mask (0–100 %), categories (class names) or height layer as a coarse grid over a region, row by row from north to south. For exact work use describe_region, find_spots or the edit tools instead of reading every cell.
find_items layer, region, kind, props, near, max_distance, measure, limit, offset
Items of objects, notes and vector layers with filters: region, kind, properties, distance to a point. measure adds facts per item: the distance to the nearest feature of other layers (e.g. roads, water), the height, the slope, the zone.
analyze_items layer, region, kind, min_distance, cluster_distance, gaps
How items are spread in a region: nearest-neighbor distances, pairs closer than min_distance, groups (items within cluster_distance of each other) and the largest empty gaps. Use it to check or even out placements while keeping groups.
find_spots metric, region, layers, radius, min_area, limit, min_separation
Finds the best spots in a region by a measure of the terrain and the layers, as ranked areas with a center point. open: far from cover (open, exposed ground); enclosed: much cover around (poor view, hidden); high / low: above / below the surroundings (viewpoints, hollows); flat / steep: slope; empty: far from any item and cover (looks empty); far_from / near_to: distance to given layers.
analyze_walkability region, max_slope, blocking, start, check, narrow_width
Walkable ground in a region (slope below max_slope, outside blocking layers such as water, cliffs, buildings) split into connected parts: the main part (from start, else the largest), isolated pockets where a player could get stuck or never get to, narrow passages, and items standing on blocked or isolated ground.
find_route from, to, max_slope, blocking, prefer, avoid, add_to, comment
The best walking route between two places on the terrain: not steeper than max_slope, around blocking layers, preferring some layers (roads) and keeping away from others (enemies, danger zones). Returns the route as points; add_to adds it as a path to a vector layer.
add_items layer, items, comment
Adds items to an objects, notes or vector layer. Objects: {kind, x, z, yaw?, w?, d?, props?} (zone is filled from the zones layer). Place an object one of three ways: its center x, z and yaw (degrees counter-clockwise seen from above: its length w points along (cos yaw, −sin yaw) — 0 east, 90 north, −90 south); its two ends "a": [x,z] and "b": [x,z] (center, yaw and, for footprints, the length w follow; d is its width, default 3 m) — use it for bridges, walls, fences, anything from one point to another; or x, z and "towards": [x,z] (its length points there). Notes: {x, z, text, color?}. Paths: {kind, points: [[x,z] or [x,z,width]...], closed?, width?, smooth?, props?}. Match the usual size of the kind (get_map_info → kind_sizes). The result has "checks" when something looks wrong (overlaps, water, a bridge along the river…). One undo step for the user.update_items layer, items, comment
Changes items by id: set fields ({"id":3,"kind":"ruin"}), merge properties ({"id":3,"props":{"level":5}}, null removes one), move by an offset ({"id":3,"move":[dx,dz]}), turn ({"id":3,"turn":90}, degrees counter-clockwise), place anew by its ends ({"id":3,"a":[x,z],"b":[x,z]}) or point it ({"id":3,"towards":[x,z]}). One undo step.delete_items layer, ids, region, kind, comment
Deletes items of a layer by ids, or all items matching region and kind. The app may ask the user to confirm. One undo step.
scatter_items layer, region, kind, kinds, spacing, count, density, keep_away, groups, yaw, props, random_props, seed, dry_run, comment
Places many objects naturally (blue-noise spacing) in a region: weighted kinds, a minimum spacing, an optional count, a density layer, distances to keep from other layers, groups (packs of 3–5 around a center), random rotation and properties. Existing items of the layer keep the spacing too. dry_run returns the positions without adding. One undo step.
paint_layer layer, region, value, mode, feather, noise, strength, comment
Paints a mask (value in percent) or a categories layer (value: a class name) over a region, with a soft edge (feather) and natural variation (noise). Modes: set, max (only raise), min (only lower), add, subtract, erase. One undo step.
edit_terrain op, region, layer, amount, height, radius, scale, from, to, feather, strength, seed, comment
Changes the height layer in a region with a soft edge. raise / lower by amount; flatten to height (default: the mean height there); smooth with radius; slope: an even ramp from one place to another (the heights there, or given ones); noise: natural bumps of amount with scale. One undo step.
create_layer name, type, group, note, color, classes, style, marker, size, label, width, dash, comment
Creates a layer: mask, category (classes), height, objects (style marker or footprint), notes or vector (paths). It goes on top of its group. One undo step.
update_layer layer, name, note, group, color, visible, opacity, label, width, add_classes, rename_classes, comment
Changes the settings of a layer: name, note, group, color, visible, opacity, label, width, add or rename categories classes. The agent cannot unlock layers. One undo step.
show_on_map region, items, point, message, select
Moves the user's view to a region, items or a point and outlines it for a few seconds, with an optional message. select: also make it the selected area. Use it to point at what you changed or found.
check_change id, items, images, size, layers
Shows you your open change (between begin_change and end_change, or a proposal waiting for review) before the user judges it: two images of the place — BEFORE and AFTER, with your objects outlined and labeled (#id kind; bridges with a line from end a to b; problems in red) — what changed per layer, and checks of every object placed or moved: overlaps with other objects, standing in water or on a road, uneven ground (with the flatten call), bridges (both ends on dry land, crossing the water, the angle to the flow: 90° is straight across). end_change runs the same checks and does not finish while problems are left. With "items" it checks objects already on the map. Look at the images: do they match what the user asked?
find_crossing region, water, bank, width, max_length, near, limit
Finds the narrowest places to cross a river or other water in a region (default: the user's selected area, else the view): for each, the two points on the banks — a and b, on dry land — for a bridge straight across the flow, its length, the width of the water, the yaw, the angle to the flow, the heights and slopes at both ends, and objects in the way. Then add_items {"kind": "<bridge>", "a": a, "b": b, "d": <width>}. Also lists the crossings already on the map (kinds and sizes).begin_change title, description
Groups the next changing calls into one change the user sees on a card over the map with your title and description, until end_change. In review mode (get_map_info → review_mode on, the default) it is one proposal: the steps apply at once but are held until the user accepts, asks for changes or rejects it all. Without review mode it becomes one undo step. Use it whenever one idea takes more than one call (e.g. ruins + rubble + overgrowth). Without it each changing call is its own change (in review mode: its own proposal, which waits for the decision).
end_change summary, title, ignore_problems, wait
Ends the change opened with begin_change. First it checks the objects of the change (as check_change): while problems are left (overlaps, objects in the water, a bridge along the river or with an end in the water…) the change stays open and you get the problems — fix them and call end_change again, or give "ignore_problems" with the reason. In review mode it then shows the proposal to the user and waits for the decision (up to "wait" seconds): accepted (kept and saved), changes_requested (undone; "feedback" says what the user wants instead: make a new change), rejected (undone), or pending (call wait_for_review). Without review mode the change is applied as one undo step (status done).
wait_for_review id, wait
Waits for the user to decide on a proposal (up to "wait" seconds) and returns the decision: accepted, changes_requested (with "feedback"), rejected, or pending (still waiting: call again).
undo steps
Undoes the latest changes made by the agent (only while they are the latest changes in the app). In review mode: withdraws your proposal that waits for review.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=18 |
| Source | github.com/aleserb/game-world-painter |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-CHuHSvlvyoNhqGo9My+QisAxLiLXewWQHX5zmo+/hJQQ2XBTUISdIt+tdJ7/YXMNUCfQB9eElkc9YSr1S7srGw== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/game-world-painter-mcp)
New version out? Ask for a fresh report.