Editor

You can run this MCP server to connect an LLM workflow with Phaser Editor v5, enabling seamless creation and management of scenes, assets, and other editor features from your AI tooling. This guide shows how to use the server with an MCP client, how to install and run it, and how to configure it for your Phaser Editor project.

How to use

You will connect an MCP client to the Phaser Editor MCP server to access editor-focused tools from your AI-assisted workflow. Use the client’s standard MCP connection flow to load the server, then invoke tools to list scenes, open scenes, modify objects, manage assets, and handle tilemaps. The server is designed to work with Phaser Editor v5 and its Scene Editor, Asset Pack Editor, and related features. When you issue commands through the MCP client, you can inspect scenes, create new ones, and update objects directly within the editor context, while maintaining synchronization with your project’s source.

How to install

Prerequisites: ensure you have Node.js installed on your system. You may also need npm or npx to run MCP server commands.

Install the MCP server package in your project workspace and add the configured host entry for your MCP client so you can connect to Phaser Editor v5.

{
  "mcpServers": {
    "phaser-editor": {
      "command": "npx",
      "args": ["@phaserjs/editor-mcp-server"]
    }
  }
}

Additional sections

Configuration details are expressed below so you can enable the MCP server with your editor client. The following configuration snippet shows how to wire the server into your MCP host (for example, Cursor or another compatible client). Use this exact structure to ensure the server is discovered and invoked correctly by your MCP client.

Security and usage notes: the server is intended to work through the Phaser Editor v5 desktop application. Changes are performed through the editor instance and tools are tailored to interact with Phaser Editor features rather than directly editing the project’s source code. You can combine editor-based tooling with your code editor to enable a synchronized workflow between editor files and source code.

Training and context tips: to improve LLM output quality for level or scene generation, provide well-structured training levels explicit about layers and object naming. For example, create a TrainingLevel scene with one layer per object named descriptively (e.g., pipe, cloud, mountain) to help the model learn patterns for content generation within Phaser Editor scenes.

Tools overview notes: the MCP server exposes a comprehensive set of tools to work with scenes, assets, and tilemaps inside Phaser Editor. These tools are designed to complement the editor experience and enable powerful, context-aware AI-assisted workflows.

Tools overview (highlights)

The server provides a rich set of tools categorized by their editor-focused capabilities. Use them through your MCP client to interact with your Phaser Editor project.

- ide-get-all-scenes-in-project
- ide-get-active-scene
- ide-open-scene
- ide-create-new-scene
- ide-save-scene
- assets-get-available-textures
- assets-get-texture-binary
- assets-get-available-bitmapfonts
- assets-get-bitmapfont-image
- assets-get-spritesheet-image
- assets-get-texture-content-bounding-box
- assets-get-available-animations
- assets-get-available-spine-skeletons
- assets-get-available-spine-atlases
- assets-get-spine-skeleton-info
- assets-get-spine-skin-image
- assets-get-available-tilemaps
- assets-get-tilemap-data
- scene-clear-scene
- scene-get-scene-dimension
- scene-get-screenshot
- scene-get-scene-data
- scene-move-game-object-in-render-list
- scene-delete-game-objects
- scene-move-game-objects-to-parent
- scene-pack-objects-in-container
- scene-delete-plain-objects
- scene-add-game-objects
- scene-update-game-objects
- scene-add-plain-objects
- scene-update-plain-objects
- scene-add-editable-tilemap
- scene-add-tileset-to-editable-tilemap
- scene-delete-tileset-from-editable-tilemap
- scene-add-editable-tilemap-layer
- scene-resize-editable-tilemap-layer
- scene-write-editable-tilemap-layer-data
- scene-fill-editable-tilemap-layer-data
- scene-get-editable-tilemap-layer-selection-data

Available tools

ide-get-all-scenes-in-project

Lists all scenes in the project.

ide-get-active-scene

Gets the currently focused scene in the editor.

ide-open-scene

Opens a scene in the editor.

ide-create-new-scene

Creates a new scene file.

ide-save-scene

Saves the editor state of a scene.

assets-get-available-textures

Lists all textures available in the project.

assets-get-texture-binary

Retrieves the binary data of a texture.

assets-get-available-bitmapfonts

Lists all bitmap fonts available in the project.

assets-get-bitmapfont-image

Gets the PNG image of a bitmap font.

assets-get-spritesheet-image

Gets the PNG image of a spritesheet.

assets-get-texture-content-bounding-box

Gets the bounding box of a texture’s content.

assets-get-available-animations

Lists all available animations for sprites.

assets-get-available-spine-skeletons

Lists all Spine skeletons in the project.

assets-get-available-spine-atlases

Lists all Spine atlases in the project.

assets-get-spine-skeleton-info

Gets info (animations and skins) for a Spine skeleton.

assets-get-spine-skin-image

Gets the PNG image of a Spine skin.

assets-get-available-tilemaps

Lists all available Tiled tilemap files.

assets-get-tilemap-data

Gets the data of a Tiled tilemap file.

scene-clear-scene

Clears the current scene.

scene-get-scene-dimension

Gets the dimensions of the current scene.

scene-get-screenshot

Gets a screenshot of the scene.

scene-get-scene-data

Gets all objects in the current scene, including their properties.

scene-move-game-object-in-render-list

Sorts objects in the current scene.

scene-delete-game-objects

Deletes specified game objects from the scene.

scene-move-game-objects-to-parent

Moves objects to a specified parent.

scene-pack-objects-in-container

Groups objects in a container.

scene-delete-plain-objects

Deletes specified plain objects from the scene.

scene-add-game-objects

Adds multiple new game objects to the scene.

scene-update-game-objects

Updates multiple game objects in the scene.

scene-add-plain-objects

Adds multiple new plain objects to the scene.

scene-update-plain-objects

Updates multiple plain objects in the scene.

scene-add-editable-tilemap

Adds a new editable tilemap to the scene.

scene-add-tileset-to-editable-tilemap

Adds a tileset to an editable tilemap and updates tile IDs in all layers.

scene-delete-tileset-from-editable-tilemap

Removes a tileset from an editable tilemap and updates tile IDs in all layers.

scene-add-editable-tilemap-layer

Adds a new layer to an editable tilemap and the scene.

scene-resize-editable-tilemap-layer

Resizes an editable tilemap layer’s data.

scene-write-editable-tilemap-layer-data

Updates part of the tile data in a layer for efficient changes.

scene-fill-editable-tilemap-layer-data

Fills a region of a layer with a single tile ID.

scene-get-editable-tilemap-layer-selection-data

Retrieves selected tile data from a layer as a 2D array.