{"report":"{\"v\":1,\"package\":\"game-world-painter-mcp\",\"version\":\"0.3.1\",\"ranAt\":\"2026-11-16T11:55:58.891Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-CHuHSvlvyoNhqGo9My+QisAxLiLXewWQHX5zmo+/hJQQ2XBTUISdIt+tdJ7/YXMNUCfQB9eElkc9YSr1S7srGw==\",\"deps\":0,\"scripts\":[],\"bins\":[\"game-world-painter-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=18\",\"repository\":\"git+https://github.com/aleserb/game-world-painter.git\",\"bin\":\"game-world-painter-mcp\"},\"start\":{\"ok\":true,\"ms\":61,\"serverName\":\"game-world-painter\",\"serverVersion\":\"0.3.1\",\"protocol\":\"2025-06-18\",\"stderr\":\"[gwp-mcp] listening on http://127.0.0.1:38765 (the app connects here)\\n[gwp-mcp] agent: bragproof (stdio)\\n\"},\"tools\":[{\"name\":\"get_map_info\",\"description\":\"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.\",\"params\":[]},{\"name\":\"open_map\",\"description\":\"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.\",\"params\":[\"path\",\"browser\"]},{\"name\":\"create_map\",\"description\":\"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.\",\"params\":[\"path\",\"title\",\"unit\",\"width\",\"height\",\"cell\",\"center\",\"layers\",\"browser\"]},{\"name\":\"get_user_context\",\"description\":\"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\\\".\",\"params\":[]},{\"name\":\"get_project_path\",\"description\":\"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\\\".\",\"params\":[\"path\"]},{\"name\":\"render_map\",\"description\":\"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.\",\"params\":[\"region\",\"layers\",\"size\",\"grid\",\"labels\",\"highlight\",\"format\"]},{\"name\":\"describe_region\",\"description\":\"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.\",\"params\":[\"region\",\"list_items\"]},{\"name\":\"read_layer\",\"description\":\"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.\",\"params\":[\"layer\",\"region\",\"resolution\"]},{\"name\":\"find_items\",\"description\":\"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.\",\"params\":[\"layer\",\"region\",\"kind\",\"props\",\"near\",\"max_distance\",\"measure\",\"limit\",\"offset\"]},{\"name\":\"analyze_items\",\"description\":\"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.\",\"params\":[\"layer\",\"region\",\"kind\",\"min_distance\",\"cluster_distance\",\"gaps\"]},{\"name\":\"find_spots\",\"description\":\"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.\",\"params\":[\"metric\",\"region\",\"layers\",\"radius\",\"min_area\",\"limit\",\"min_separation\"]},{\"name\":\"analyze_walkability\",\"description\":\"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.\",\"params\":[\"region\",\"max_slope\",\"blocking\",\"start\",\"check\",\"narrow_width\"]},{\"name\":\"find_route\",\"description\":\"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.\",\"params\":[\"from\",\"to\",\"max_slope\",\"blocking\",\"prefer\",\"avoid\",\"add_to\",\"comment\"]},{\"name\":\"add_items\",\"description\":\"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.\",\"params\":[\"layer\",\"items\",\"comment\"]},{\"name\":\"update_items\",\"description\":\"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.\",\"params\":[\"layer\",\"items\",\"comment\"]},{\"name\":\"delete_items\",\"description\":\"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.\",\"params\":[\"layer\",\"ids\",\"region\",\"kind\",\"comment\"]},{\"name\":\"scatter_items\",\"description\":\"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.\",\"params\":[\"layer\",\"region\",\"kind\",\"kinds\",\"spacing\",\"count\",\"density\",\"keep_away\",\"groups\",\"yaw\",\"props\",\"random_props\",\"seed\",\"dry_run\",\"comment\"]},{\"name\":\"paint_layer\",\"description\":\"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.\",\"params\":[\"layer\",\"region\",\"value\",\"mode\",\"feather\",\"noise\",\"strength\",\"comment\"]},{\"name\":\"edit_terrain\",\"description\":\"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.\",\"params\":[\"op\",\"region\",\"layer\",\"amount\",\"height\",\"radius\",\"scale\",\"from\",\"to\",\"feather\",\"strength\",\"seed\",\"comment\"]},{\"name\":\"create_layer\",\"description\":\"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.\",\"params\":[\"name\",\"type\",\"group\",\"note\",\"color\",\"classes\",\"style\",\"marker\",\"size\",\"label\",\"width\",\"dash\",\"comment\"]},{\"name\":\"update_layer\",\"description\":\"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.\",\"params\":[\"layer\",\"name\",\"note\",\"group\",\"color\",\"visible\",\"opacity\",\"label\",\"width\",\"add_classes\",\"rename_classes\",\"comment\"]},{\"name\":\"show_on_map\",\"description\":\"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.\",\"params\":[\"region\",\"items\",\"point\",\"message\",\"select\"]},{\"name\":\"check_change\",\"description\":\"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?\",\"params\":[\"id\",\"items\",\"images\",\"size\",\"layers\"]},{\"name\":\"find_crossing\",\"description\":\"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).\",\"params\":[\"region\",\"water\",\"bank\",\"width\",\"max_length\",\"near\",\"limit\"]},{\"name\":\"begin_change\",\"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).\",\"params\":[\"title\",\"description\"]},{\"name\":\"end_change\",\"description\":\"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).\",\"params\":[\"summary\",\"title\",\"ignore_problems\",\"wait\"]},{\"name\":\"wait_for_review\",\"description\":\"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).\",\"params\":[\"id\",\"wait\"]},{\"name\":\"undo\",\"description\":\"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.\",\"params\":[\"steps\"]}],\"toolsHash\":\"d58cfc7de3ac7b0995dcc8a75a596ab4393f58d6cd09c00cb72e322bd4c0b41f\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:56:02.734Z\",\"calls\":[{\"tool\":\"get_map_info\",\"ok\":false,\"ms\":4006,\"bytes\":0,\"error\":\"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 local copy), open their map, and turn on AI Agent in the header \"},{\"tool\":\"get_user_context\",\"ok\":false,\"ms\":4001,\"bytes\":0,\"error\":\"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 local copy), open their map, and turn on AI Agent in the header \"},{\"tool\":\"get_project_path\",\"ok\":false,\"ms\":4006,\"bytes\":0,\"error\":\"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 local copy), open their map, and turn on AI Agent in the header \"},{\"tool\":\"find_items\",\"ok\":false,\"ms\":4003,\"bytes\":0,\"error\":\"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 local copy), open their map, and turn on AI Agent in the header \"},{\"tool\":\"find_crossing\",\"ok\":false,\"ms\":4005,\"bytes\":0,\"error\":\"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 local copy), open their map, and turn on AI Agent in the header \"}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OjJkZmMxZGE0ZWFmMDViNGVmMjdhOTRkZmQ4YmRiZjZiMmJhNmU1N2E3MGE4OThjNmE3MzU1ZDk2MzRhMjFmYjgiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTMyNCIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgzMDQ4NywiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4MzAxODcsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiYzg3Y2Y3MWItOTdlZS00ZGQ2LTk4MzYtOTZiNDA4NmRlMzBhIiwibmJmIjoxNzk0ODI5ODg3LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.HtsIvcfKGlMLCFwouK178wL65nh-_-t8la6cCDNVe25LFdoo91oGmgBBiQ3lAzA4-b9EsWyj2l1dKNIWIGhzgov-qANAjjpbq8_J27vc937X5iJ9QzRZ0dbw20oT5zqjljGJBtazy5CIaMvFk97_-33EGjfwWv_frmc74j5itGaDpTOM2gdhXcG1f3IQcJkGWThfV6TFAh7TUIZGtLlQjtNyMXa2GfcdqqBX21d_90bClf9d0H2DnAsi30kPF34IyCoQLKdVJyhGOHNvyvKEphN51sWhJRCc6npN06sCWdALljnx3TiJ37oJ6DxVrrg1Z2BF4KPodyh7uMlPK_2ZjQ"}