v0.0.1 — first npm release
TiledMCP is now on npm as tiled-mcp-server. No clone, no build:
claude mcp add tiled -- npx -y tiled-mcp-server --project-dir /absolute/path/to/your/tiled-projectOr for Claude Desktop / any JSON-config MCP client:
{
"mcpServers": {
"tiled": {
"command": "npx",
"args": ["-y", "tiled-mcp-server", "--project-dir", "/absolute/path/to/your/tiled-project"]
}
}
}Requires Node.js 20.19+. Tiled itself is not required — 50 tools run on the built-in JSON/PNG path; installing Tiled adds tiled_render_map and tiled_preview_export.
What's in 0.0.1
- 52 tools covering read, edit, procedural generation, native PNG rendering (all four projections), byte-exact TMX/TSX/TX writing, checkpoints, and cross-file transactions
- Every write goes preview → human approval → apply under a revision guard; undefined Tiled semantics fail closed instead of being approximated
- Four MCP prompts carry whole workflows (
create_map_from_tilesheet,build_from_floor_plan,set_up_tile_roles,review_map) - A sectioned guide resource (
tiled://guide/{section}), a 106-code stable error registry, and cursor pagination across the listing tools - 1,524 tests; the machine contract in
contracts/mcp-contract.v1.jsonis generated from real discovery and drift-gated in CI
The interface is a draft and not yet frozen.