Skip to main content
Glama
nahuelgallo

ultimate-construct3-mcp

by nahuelgallo
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

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.

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nahuelgallo/ultimate-construct3-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server