Check what O3DE MCP capabilities are currently available.

Call this first to determine whether the editor is connected (for editor tools) and whether the O3DE CLI is available (for project tools). This avoids wasting tokens on tools that will fail.

Tool categories are discovered dynamically — any new tools added to the server will automatically appear in the response.

Returns: JSON object with editor, cli, and tool_categories sections describing current availability and configuration.

Execute a Python script inside the running O3DE Editor.

The script runs in the editor's embedded Python interpreter and has access to the full azlmbr (EditorPythonBindings) API. Use this for custom editor automation that isn't covered by other tools.

Args: script: Python code to execute. Has access to azlmbr modules. timeout: Optional per-call execution timeout in seconds. The editor runs the script synchronously and does not reply until it finishes, so raise this for known-heavy operations. Omit to use the O3DE_EDITOR_TIMEOUT default (600s).

Return the full scene state as JSON, served natively by the AiCompanion gem.

Entities, components, transforms and hierarchy in one call, produced by the gem's C++ SceneSnapshotProvider rather than an editor Python script. Cheaper than list_entities plus per-entity queries, and it still works when the AgentServer runs in secure mode.

Return the entity hierarchy as a nested JSON tree.

Served natively by the AiCompanion gem, without editor Python.

Run the AiCompanion gem's scene validation and return the report as JSON.

Flags common problems (missing cameras, entities without transforms, physics bodies without colliders, and similar) without executing any editor Python.

List all entities in the currently open O3DE level.

Returns a JSON array of objects with 'id' and 'name' fields.

Create a new entity in the current O3DE level.

Args: name: Name for the new entity. parent_id: Optional entity ID of the parent. None for root-level.

Delete an entity from the current O3DE level.

Args: entity_id: The entity ID to delete.

Duplicate an entity (and its children) in the current O3DE level.

Args: entity_id: The entity ID to duplicate.

List all components attached to an entity.

Args: entity_id: The entity ID to inspect.

Returns: JSON array of objects with 'component_id' and 'type' fields.

Add a component to an entity.

Args: entity_id: The entity ID to add the component to. component_type: Component type name (e.g. 'Mesh', 'PhysX Dynamic Rigid Body').

Get a property value from a component on an entity.

Args: entity_id: The entity ID. component_type: Component type name (e.g. 'Transform'). property_path: Property path using '|' separator (e.g. 'Controller|Configuration|Model Asset').

Set a property value on a component.

Args: entity_id: The entity ID. component_type: Component type name (e.g. 'Transform'). property_path: Property path using '|' separator (e.g. 'Controller|Configuration|Model Asset'). value: The value to set (as a string — booleans as 'true'/'false', numbers as their string representation).

Assign an asset to a component property by resolving the asset path.

Remove a component from an entity.

Set the world transform of an entity (only provided components are changed).

Get the world transform of an entity.

Set the parent of an entity (reparent in the hierarchy).

Execute an O3DE console command in the running editor.

Get the value of an O3DE console variable (CVAR).

Set the value of an O3DE console variable (CVAR).

Open a level in the O3DE Editor.

Args: level_path: Path to the level relative to the project (e.g. 'Levels/MyLevel').

Get information about the currently loaded level.

Returns: JSON object with 'level_name' and 'level_path' fields.

Save the currently open level.

Create a new empty level in the current O3DE project.

List all levels available in an O3DE project.

Enter game mode (play-in-editor) in the O3DE Editor.

Exit game mode and return to edit mode.

Undo the last editor action.

Redo the last undone editor action.

Get the position and rotation of the active editor viewport camera.

Returns JSON with position (3 floats) and rotation (3 Euler angles in degrees). FOV is not available via the Python bindings.

Set the active editor viewport camera transform.

Focus the viewport camera on an entity.

Capture a screenshot of the editor viewport.

Tries PySide6 widget grab first (captures the viewport widget including UI overlays). Falls back to azlmbr.atom FrameCaptureRequestBus.CaptureScreenshot which captures the actual rendered frame and works on platforms where PySide6 is not importable in the editor's embedded interpreter.

Args: output_path: File path for the screenshot (.png, .jpg, .jpeg, .bmp, or .tga). width: Optional width to scale the screenshot to (PySide6 path only). height: Optional height to scale the screenshot to (PySide6 path only).

Instantiate a prefab in the current level.

Write a prefab file to disk from an existing entity.

The path is relative to the project root. The level is not modified; use instantiate_prefab afterwards to place the saved prefab.

Report where a prefab instance came from.

Propagating live entity edits back to a .prefab file is not reachable from the editor's Python API: PrefabPublicRequestBus reflects no save event, and the only serialiser, SaveTemplateToString, is keyed by template id with nothing exposed to map an entity to one. This returns the owning prefab path and says so, rather than reporting a success that never happened. To get a prefab onto disk, use create_prefab_from_entity.

Begin a persistent Python session in the O3DE editor.

Execute Python code in a persistent session.

End a persistent Python session and clean up its namespace.

List the variable names in a persistent Python session.

Discover the scripting API of any O3DE gem's reflected EBuses.

Query the running editor's BehaviorContext for a bus schema.

Trigger a RenderDoc frame capture in the O3DE editor.

Attempts to trigger a RenderDoc capture via GraphicsProfilerBus (reflected in the BehaviorContext but not exposed as a Python bus function in O3DE 2.7.0). If the bus call is not available, reports the limitation and suggests manual alternatives.

Returns: JSON with status ok if the capture was triggered, error on failure, or manual_required if the Python API cannot trigger the capture and manual action is needed.

Get information about the local O3DE engine installation.

Returns: JSON object with engine metadata, or an error message if no engine is found.

List all O3DE projects registered on this machine.

Returns: JSON array of project objects, or a message if none are found.

List all external gems registered on this machine.

Returns: JSON array of gem objects, or a message if none are found.

List gems enabled in a specific O3DE project.

Args: project_path: Path to the O3DE project.

Create a new O3DE project.

Args: name: Project name (alphanumeric, hyphens, underscores). path: Directory where the project will be created. template: Project template to use (default: DefaultProject).

Register an external gem with an O3DE project.

Args: gem_path: Path to the gem directory. project_path: Path to the project to add the gem to.

Enable a gem in an O3DE project.

Args: gem_name: Name of the gem to enable. project_path: Path to the project.

Build an O3DE project using CMake.

This runs CMake configure followed by CMake build. Timeouts are configurable via O3DE_CONFIGURE_TIMEOUT and O3DE_BUILD_TIMEOUT environment variables.

Args: project_path: Path to the O3DE project. config: Build configuration -- profile, debug, or release (default: profile).

Disable a gem in an O3DE project.

Args: gem_name: Name of the gem to disable. project_path: Path to the project.

Create a new O3DE gem.

Args: name: Gem name (alphanumeric, hyphens, underscores). path: Directory where the gem will be created. template: Gem template to use (default: DefaultGem).

Export an O3DE project for distribution.

This is a long-running operation. Timeout is configurable via the O3DE_EXPORT_TIMEOUT environment variable (default: 3600s).

Args: project_path: Path to the O3DE project to export. output_path: Directory where the exported project will be written. config: Build configuration -- profile, debug, or release (default: profile).

Edit properties of an existing O3DE project.

Args: project_path: Path to the project. project_name: New name for the project (optional). origin: New origin URL or description (optional).

List available O3DE project and gem templates.

Scans the engine's Templates directory for template definitions.

Returns: JSON array of template objects with name, summary, and path.

Register an O3DE engine installation with the O3DE manifest.

Args: engine_path: Path to the engine root directory (must contain engine.json).

Set the active O3DE engine by name (in-process, not persistent).

Args: name: Name of the registered engine to activate.

Start a CMake build in the background and return a build ID.

Unlike build_project, this returns immediately with a build ID that can be polled via get_build_status. Output is drained on a background thread to prevent pipe stalls on large builds.

Args: project_path: Path to the O3DE project. config: Build configuration -- profile, debug, or release (default: profile). target: Optional CMake target to build (default: all targets).

Check the status of a background build.

Args: build_id: Build ID returned by start_build.

Check whether the O3DE Asset Processor is running.

Wait for the Asset Processor to finish processing (or until timeout).

Trigger an Asset Processor rescan for a project.

Read the last N lines of an O3DE log file.

Extract error lines from an O3DE log file.