Skip to content

v0.0.1 — first npm release

Choose a tag to compare

@sitapix sitapix released this 06 Aug 22:47
· 25 commits to main since this 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-project

Or 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.json is generated from real discovery and drift-gated in CI

The interface is a draft and not yet frozen.