Log inSubmit server

Archlang MCP README

The full upstream README, mirrored for reference. Install config, tool schemas, adoption signals and our own overview live on the Archlang MCP listing page.

Back to Archlang MCP View source on GitHub
ArchLang

Floor plans as code.

ArchLang is an open-source (MIT) DSL for floor plans that compiles .arch source to SVG/DXF/PDF with linting and geometric validation — diffable, reproducible, and LLM-writable.

Playground Docs Gallery npm

A brief given to a coding agent, and the ArchLang it wrote compiling into a dimensioned plan of 3 rooms and 31.97 m² net. Then one number changes and the plan redraws, and a lint finding is raised and cleared. Output: SVG, PDF, DXF, PNG.

Try it

Just looking? Open the playground — no install.

Your coding agent: paste this prompt.

text
1. Run: npx -y skills add ChanMeng666/archlang --yes
2. Run: npx -y @chanmeng666/archlang spec   (read it before writing anything)
3. Write my floor plan as plan.arch from this brief: <describe rooms, areas, adjacencies>
4. Run: npx -y @chanmeng666/archlang compile plan.arch -o plan.svg --json
   then describe plan.arch --json, validate plan.arch --strict --json (same prefix); fix, recompile
5. Run: npx -y @chanmeng666/archlang finish plan.arch, then compile again to export.
Starting from a photo or PDF? Read https://archlang.uk/from-an-image. To change one room without moving the others, use `impact --lock` (https://archlang.uk/edit-one-room).

Or add the MCP server: claude mcp add --transport http archlang https://mcp.archlang.uk/mcp (locally, claude mcp add archlang -- npx -y @chanmeng666/archlang-mcp). The skills are listed on skills.sh.

What you get

Each drawing is compiled from a file in examples/. Click a plan to open its source in the playground, then change a number and watch it redraw; click a 3D preview to open it on the 3D view.

A one-bedroom laneway house: a living kitchen, a bedroom and a bath. Opens in the playground.
Laneway house		The laneway house plan extruded to a 3D preview in flat colours: walls, openings, floors and furniture. Opens in the playground on the 3D view.
Laneway house, 3D preview
A studio flat: a living kitchen, a bedroom, a hall and a bath. Opens in the playground.
Studio flat		The studio flat plan extruded to a 3D preview in flat colours: walls, openings, floors and furniture. Opens in the playground on the 3D view.
Studio flat, 3D preview

Same source, plan and 3D preview. The 3D preview is extruded from the same .arch file by the separate archlang-3d package, and checked against the plan: every 3D element comes from the plan's elements, and every solid is closed. What the 3D preview shows → · Try it in 3D →

3D preview: walls, openings, floors, stairs, furniture, outdoor surfaces and fences in flat colours; the ground is a backdrop the viewer draws, not part of the building and not in the file; no pitched roofs or balcony railings yet, and no sections, elevations or BIM.

More plans from examples/:

A two-bedroom flat with a kitchen-living room, a hall and a bathroom. Opens in the playground.
Two-bedroom flat		A tiny house: one living and sleeping room and a wet room. Opens in the playground.
Tiny house		A hexagonal pavilion: six rooms ringing a round central rotunda. Opens in the playground.
Hexagon pavilion

Why text

  • Exact. Areas and reachability are computed, not estimated; the same text gives the same drawing, byte for byte.
  • Change one line, see what moved. Edit a number and just what depends on it moves; impact --lock proves the rest didn't.
  • It checks itself. An unreachable room or an opening off its wall comes back as a message with a code and a fix your AI can apply; checks other than reachability and area are advisory. The checks → · Error codes →

What writing it as a language gives you. Rooms, walls, doors and windows have names, so the compiler can measure each room and check how the rooms connect; some mistakes come back as a message with a code that points at the exact place in the text, often with a fix (other checks are advisory); the same text gives the same bytes every time, and impact shows which parts of the drawing a change moved. More →

Limits: plan drawings in the core; no BIM or IFC, not permit drawings; it does not read images; clearances are advisory. The 3D preview's limits, as the line under the plan pairs above says: "3D preview: walls, openings, floors, stairs, furniture, outdoor surfaces and fences in flat colours; the ground is a backdrop the viewer draws, not part of the building and not in the file; no pitched roofs or balcony railings yet, and no sections, elevations or BIM."

Starting from a photo? archlang.uk/from-an-image · Change one room? archlang.uk/edit-one-room

For your agent

This page is all a person needs. Everything else is written for agents: clone the repo and point yours at AGENTS.md, or give it the whole language in one call:

Terminal
npx -y @chanmeng666/archlang context

MCP clients: archlang.uk/mcp · Agents: archlang.uk/agents · Full overview · Language reference

Local MCP server: Install in VS Code · Install in VS Code Insiders. Hosted MCP server: Install in VS Code · Install in VS Code Insiders. Install in Cursor: the links on archlang.uk/mcp.

https://github.com/user-attachments/assets/879a4b71-415e-4848-a4af-db9c879d6a71

Watch the full film on YouTube (3:16)

What's new →

Release notes (installed: node_modules/@chanmeng666/archlang/CHANGELOG.md) · Contributing · MIT

ArchCanvas is a hosted app built on ArchLang. Maintained by Chan Meng, a single maintainer; written with AI coding agents and checked in CI. Governance.