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.

Available Tools

6 tools
get_ace_referenceB

Get the Actions, Conditions, and Expressions (ACE) reference for a Construct 3 plugin or behavior.

Inputs: plugin (required), lang.

get_docB

Get the full markdown content of a Construct 3 documentation topic.

Inputs: topic (required), lang, category.

get_examplesB

Search for code examples and snippets from the Construct 3 documentation.

Inputs: query (required), lang, limit.

list_categoriesB

List all documentation categories with descriptions and topic counts.

Inputs: lang.

list_topicsB

List all available Construct 3 documentation topics, optionally filtered by category.

Inputs: lang, category.

search_docsA

Full-text search across Construct 3 documentation. Returns matching topics with relevance-scored snippets.

Inputs: query (required), lang, limit, category.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 6 tools

    Disambiguation4/5

    Each tool targets a distinct facet of the docs surface (search, browse topics, browse categories, fetch topic, ACE reference, examples). The only mild overlap is between search_docs and get_examples, since both are query-style lookups, but the example-specific description makes the boundary clear enough.

    Naming Consistency5/5

    All names follow a clean verb_noun snake_case pattern (search_*, list_*, get_*), with verbs matching the operation type. No mixed conventions.

    Tool Count5/5

    Six tools is a well-scoped set for a documentation lookup server — one query tool, one content fetcher, two browsing tools, plus ACE and example lookups. Each earns its place without redundancy.

    Completeness4/5

    The surface covers the full docs workflow: browse categories/topics, search, fetch full content, and specialized ACE/example lookups. Minor gaps exist (e.g. no versioned docs or plugin-name discovery for ACE), but agents can work around them via search.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers