ultimate-construct3-mcp

Unified MCP server for Construct 3 — offline documentation, project read/write, analysis, and scripting support. 44 tools in a single server.

Quick start

With a Construct 3 project (all features)

{
  "mcpServers": {
    "construct3": {
      "command": "node",
      "args": ["path/to/ultimate-construct3-mcp/dist/index.js", "path/to/your/c3-project"]
    }
  }
}

Documentation only (no project)

{
  "mcpServers": {
    "construct3-docs": {
      "command": "npx",
      "args": ["-y", "ultimate-construct3-mcp"]
    }
  }
}

Tools (44 total)

Documentation (6 tools — always available)

| Tool | Description | |------|-------------| | search_docs | Full-text search across all Construct 3 documentation | | get_doc | Get full markdown content of a documentation topic | | list_topics | List all available documentation topics | | list_categories | List categories with topic counts | | get_ace_reference | Get Actions/Conditions/Expressions for a plugin or behavior | | get_examples | Search for code examples from the documentation |

Project Query (9 tools)

| Tool | Description | |------|-------------| | list_objects | List all object types (with optional filter) | | list_eventsheets | List all event sheets | | list_layouts | List all layouts | | list_families | List all families | | get_object_details | Get full JSON of an object type | | get_eventsheet_details | Get full JSON of an event sheet | | get_layout_details | Get full JSON of a layout | | search_objects | Search objects by name pattern | | get_project_summary | Get project metadata and statistics |

Project Mutation (14 tools)

| Tool | Description | |------|-------------| | create_object | Create a new object type (Sprite, Text, Audio, etc.) | | update_object_properties | Add/remove variables, behaviors, change global status | | delete_object | Delete an object (with reference checking) | | create_event_sheet | Create a new event sheet | | add_event_to_sheet | Add group/function/variable/include/comment events | | add_event_block | Add block events with conditions + actions (recursive) | | update_event_block | Modify existing block events | | delete_event_sheet | Delete an event sheet (with reference checking) | | delete_event_from_sheet | Delete individual events by SID | | create_layout | Create a new layout | | add_instance_to_layout | Place object instances on layout layers | | update_layout | Update layout properties | | delete_layout | Delete a layout (with reference checking) | | update_project_metadata | Update project name, version, author, description |

Animation (2 tools)

| Tool | Description | |------|-------------| | add_animation_to_sprite | Add animations with auto-generated placeholder PNGs | | update_animation_properties | Update speed, looping, ping-pong settings |

Analysis (8 tools)

| Tool | Description | |------|-------------| | get_eventsheet_flow | Event sheet include hierarchy (Mermaid/JSON) | | get_function_map | Function definitions and call sites | | get_object_dependencies | Object usage graph (events, layouts, families) | | find_orphaned_objects | Find unused objects | | get_asset_usage | Track asset usage (sound, image, font, video) | | analyze_performance | Heuristic performance audit | | validate_project | 13-check integrity validation | | get_group_settings | Group active/disabled status across event sheets |

Scripting & Files (5 tools)

| Tool | Description | |------|-------------| | list_scripts | List all JavaScript files in the project | | read_script | Read a script file's contents | | write_script | Create or modify a JavaScript file | | read_project_file | Read any project file (JSON or text) | | write_project_file | Write a JSON file to the project |

Resources (6)

• project-info — Project metadata
• project-structure — Full project structure overview
• project-addons — Used plugins, behaviors, effects
• object-details — Object type details (template)
• eventsheet-details — Event sheet details (template)
• layout-details — Layout details (template)

Prompts (6)

• analyze_project — Full project analysis
• find_object_usage — Find where an object is used
• explain_eventsheet — Explain an event sheet's logic
• review_game_logic — Review game architecture
• document_object — Generate object documentation
• optimize_project — Get optimization suggestions

Multi-language Documentation

Supported: en, es, pt-br, fr, de, it, ja, ko, zh, ru, tr

All doc tools accept a lang parameter. Falls back to English if a topic isn't translated.

Update Documentation

c3-docs-scrape --all --lang en
c3-docs-scrape --category plugins --lang en
c3-docs-scrape --topic sprite --lang es

Development

git clone <repo>
cd ultimate-construct3-mcp
npm install
npm run build
npm test

License

MIT

---

Construct 3 is developed by Scirra Ltd. This project is not affiliated with Scirra.