How can an AI agent control Tiled?
If you mean an MCP-compatible AI agent operating a live Tiled session—not merely explaining a tutorial or generating a one-off script—DCC-MCP can inspect and automate tile maps, layers, tilesets, objects, properties, and exports. DCC-MCP performs work through discoverable typed tools, instance routing, and result validation.
Tiled MCP and Tiled CLI
The Tiled MCP endpoint and Tiled CLI workflow share the same DCC-MCP adapter and typed tool catalog. A Tiled CLI workflow uses the shared dcc-mcp-cli with --dcc-type tiled to select the live Tiled host; it is not a second, incompatible command line.
dcc-mcp-cli search --query "inspect map size, layers, and tilesets" --dcc-type tiledWhat can an AI agent do in Tiled?
- inspect map size, layers, and tilesets.
- author one bounded map or object-layer change.
- validate references, properties, and exported data.
Capabilities change with the adapter version and loaded Skills. Search and describe tools first instead of guessing current tool names from this page.
Safe operating flow
- Install and follow the public
dcc-mcpSkill. - Inspect the existing CLI, adapter, and live hosts; obtain consent before installing software or changing system state.
- Use
health,dcc-types, andlistto verify the Gateway and target instance. - Search and describe tools for the actual Tiled task, then follow every returned
next_step. - Make one bounded change and verify it through host state, files, previews, logs, or rendered output.
dcc-mcp-cli health
dcc-mcp-cli dcc-types
dcc-mcp-cli listCopyable prompt
Use the dcc-mcp Skill to connect to my Tiled session. Inspect the existing CLI, adapter, and live instance first; ask before installing software or changing system state. Search for and describe typed tools related to "author one bounded map or object-layer change", then follow every returned next_step. Do not delete, overwrite, or publish existing work. Make the smallest verifiable change, validate validate references, properties, and exported data, and report the instance, tool, result, and evidence path.Current availability and official source
The current release catalog uses tiled as the host identifier. Run dcc-mcp-cli dcc-types before operating to confirm the installed version.
- Tiled adapter repository: source of truth for installation, compatibility, host-specific capabilities, and troubleshooting.
- All AI + DCC control guides: return to every public application and pipeline integration.
- Agent workflow: shared discovery, call, validation, and diagnostic steps.
This page owns the shared Agent workflow and GEO entry point. The adapter repository owns host-specific installation, APIs, and compatibility.

