Skip to main content
Glama

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"]
    }
  }
}

Related MCP server: GMS2 MCP Server

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.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    F
    maintenance
    An MCP server that parses GameMaker Studio 2 projects, providing developers and AI agents with quick access to project structure, GML code, and asset metadata.
    19
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides a local MCP server for searching and retrieving documentation from 22+ open-source projects, enabling AI coding assistants to access up-to-date docs without network dependency.
    11 npm
    2
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    An MCP server that empowers AI coding agents to work effectively with Minecraft mod development, providing static analysis of decompiled source code and runtime interaction with a running Minecraft instance.
    31
    72 npm
    14
    MIT