Server definition
- Hash
- sha256:c4b21c9ff396d75dc95020ff49c3ed944ad614fe9c7ad86db003da291455b670
- What it is
- What a remote MCP server returned when asked what it offers: 12 tools
The blob, as servednamed by its sha256
{
"instructions": "ArchLang compiles `.arch` text to SVG floor plans. Before writing any `.arch`, read the `archlang://spec` resource: the whole language (from a shell: `npx -y @chanmeng666/archlang spec`).\nThe loop:\n1. Write the plan as `.arch` source.\n2. `compile` it. Errors are diagnostics, usually with a byte span, often a fix; `fix` applies the machine-applicable ones, edit the rest by hand.\n3. `describe` it; check rooms, areas and doors against the brief.\n4. `validate` with strict:true (parse, resolve, `lint`); fix its next item first, then every warning, then back to 2.\n5. `finish` once lint is clean, before export: it adds what the plan lacks and deletes nothing.\nWith a shell, the CLI runs the same loop at no context cost: `archlang <cmd>`, or `npx -y @chanmeng666/archlang <cmd>` without a global install.\nEvery tool, command, limit and export format: the `archlang://capabilities` resource.",
"tools": [
{
"description": "Compile ArchLang `.arch` source (or a Plan-JSON object) to an SVG floor plan, or with `format` to a plain-text ASCII plan (\"txt\"), Plan JSON (\"json\") or an image (\"png\"). Format \"json\" returns the plan as an object, with `schema` naming its JSON Schema; passed back as `plan_json` it compiles to the same drawing, unless the plan uses a part of the language Plan JSON does not carry (sheet tables, styles, circular rooms, roofs, storeys, `place`, accessibility metadata). Returns the output plus diagnostics; a diagnostic usually carries a byte span with line/col and an E_/W_ code, and often a fix, sometimes one the `fix` tool can apply. Errors come back as data, never as exceptions: read `diagnostics` and correct the source. A multi-storey plan (`level <n> { … }`) returns the lowest storey in `output` and every storey in `pages[]` ({ level, name, output }); pass `level` to render just one. format \"png\" is unavailable on the hosted server, which has no image renderer: use format \"svg\", or GET /svg/<payload> on the hosted server for an image URL.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"accessible": {
"description": "Emit <title>/<desc>/role/aria accessibility metadata (SVG only).",
"type": "boolean"
},
"format": {
"description": "svg (default), txt (zero-dependency ASCII), json (Plan JSON, the shape `plan_json` takes) or png (an image; needs the optional renderer).",
"enum": [
"svg",
"txt",
"json",
"png"
],
"type": "string"
},
"level": {
"description": "Render only this storey of a multi-storey plan. An undeclared level is an error, not a guess.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"overlay": {
"description": "Draw an opt-in circulation overlay (SVG only).",
"enum": [
"circulation"
],
"type": "string"
},
"plan_json": {
"additionalProperties": {},
"description": "Plan JSON (RPLAN shape) as an alternative to `source`; converted to .arch then compiled.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"source": {
"description": "ArchLang source (a `plan \"…\" { … }`). Provide this OR plan_json.",
"type": "string"
},
"width": {
"description": "png only (any other format refuses it): the image width in pixels, clamped to 256-4096, and narrower for a tall plan so neither side exceeds 4096; default 1600.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"type": "object"
},
"name": "compile",
"outputSchema": null
},
{
"description": "List the completion items in scope at a source byte offset: keywords, element names, ids and enum values, the same items an editor's language server offers. For structured or assisted authoring.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"at": {
"description": "Source byte offset to complete at.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"source": {
"description": "ArchLang source.",
"type": "string"
}
},
"required": [
"source",
"at"
],
"type": "object"
},
"name": "complete",
"outputSchema": null
},
{
"description": "Report a plan's facts without rendering, so you can check it against the brief without looking at an image. Returns rooms (`area_m2`, measured on the wall centrelines; `net_area_m2`, the floor no wall stands on, absent when it cannot be computed exactly; bbox, adjacency, use, and the exact shape: `floor_polygon` for a `room polygon`, `floor_circle` for a `room circle`, whose area is exactly πR²), doors (what each connects), windows, circulation (walk distance, bottleneck width, detour), zones, storeys (`levels[i]` carries the same facts per floor) with the shafts that join them and which storeys stay reachable (`vertical`), the drawing extent (`bbox`, `bbox_outer`), `freedom` (which positions are hand-authored and which are derived), and totals (`floor_area_m2` on centrelines, `net_floor_area_m2` beside it, absent when any room's net area is).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"source": {
"description": "ArchLang source.",
"type": "string"
}
},
"required": [
"source"
],
"type": "object"
},
"name": "describe",
"outputSchema": null
},
{
"description": "Complete a plan for export by adding what it lacks; run it once `lint` is clean. Two stages. `furnish` puts furniture, by room use, in each rectangular room that holds none, on every storey (a furnished room is never touched, and one that lacks a piece its use requires is named in `unresolved` with the missing pieces, not filled; placement is `against wall` / `in <room> anchor`, never absolute). `sheet` adds the sheet statements the plan lacks (`paper`, `scale`, `dims auto`, `title`, `schedule rooms`, `legend`), choosing the finest standard scale on the smallest sheet that holds the drawing. It fills only what is missing and deletes nothing; `only` runs one stage; `reissue:true` may replace `paper`/`scale` (only those) when the drawing does not fit them. Returns { ok, changed, changes, unresolved, source }; a plan that does not compile comes back untouched with `ok:false`, and every room left empty (its use has no furniture row or is unknown, or furnishing it would raise a new diagnostic) and every sheet statement left out is named in `unresolved` with the reason; a note with `scope` set (`outside-table`) asks nothing of you unless that room should hold furniture.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"only": {
"description": "Run only this stage. Default: `furnish`, then `sheet`.",
"enum": [
"sheet",
"furnish"
],
"type": "string"
},
"reissue": {
"description": "Allow `paper` and `scale` to be replaced when the drawing does not fit the authored sheet.",
"type": "boolean"
},
"source": {
"description": "ArchLang source to finish.",
"type": "string"
}
},
"required": [
"source"
],
"type": "object"
},
"name": "finish",
"outputSchema": null
},
{
"description": "Apply the machine-applicable fixes attached to a plan's compile diagnostics and return the edited source. It corrects source-level faults (an opening off its wall becomes the attachment form, an out-of-range position is clamped, …); furniture geometry is `repair`'s job. It runs at most 4 passes and rolls back a pass that raises the error count. `unsafe:true` also applies `maybe-incorrect` fixes. Returns { ok, passes, applied, skipped, source }.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"source": {
"description": "ArchLang source to fix.",
"type": "string"
},
"unsafe": {
"description": "Also apply `maybe-incorrect` fixes (default: machine-applicable only).",
"type": "boolean"
}
},
"required": [
"source"
],
"type": "object"
},
"name": "fix",
"outputSchema": null
},
{
"description": "Make two URLs that show a plan in the browser with nothing to install, for handing to a person. `playground` opens it in the hosted editor, rendered; `embed` draws it alone, for an iframe. The plan travels inside the URL, after the `#`, so it is never sent to a server and the URL carries nothing else. A plan that does not compile still gets links, and the page shows its diagnostics; `ok` says whether it compiles, and `errors` counts the errors when it does not. `bytes` is the size of the compressed plan in the URL.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"source": {
"description": "ArchLang source.",
"type": "string"
}
},
"required": [
"source"
],
"type": "object"
},
"name": "link",
"outputSchema": null
},
{
"description": "List advisory architectural-soundness warnings (`W_*` codes) as data: unreachable room, windowless bedroom, too-narrow door, blocked doorway, furniture through a wall, circuitous path, and more. `profile` selects a ruleset (\"residential-basic\", \"accessibility-advisory\", …).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"profile": {
"description": "Advisory ruleset name (default: the built-in ruleset).",
"type": "string"
},
"source": {
"description": "ArchLang source.",
"type": "string"
}
},
"required": [
"source"
],
"type": "object"
},
"name": "lint",
"outputSchema": null
},
{
"description": "Explain this hosted ArchLang server in one short page: the authoring loop, the size cap, what is unavailable here, how to get an image URL for a plan, and what the server keeps (nothing). Call it first when unsure.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "read_me",
"outputSchema": null
},
{
"description": "Correct furniture placement and return the corrected `.arch` source with a change log. It pushes furniture out of walls, doorways and door swings, separates overlapping pieces, moves fixtures that sit in the wrong room, and snaps floating pieces to walls. A piece it may not rewrite is listed in `unresolved` with the reason. It never adds doors or windows (that is a design choice); use `suggest` for those.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"source": {
"description": "ArchLang source to correct.",
"type": "string"
}
},
"required": [
"source"
],
"type": "object"
},
"name": "repair",
"outputSchema": null
},
{
"description": "Measure how much of a brief's intent JSON a plan satisfies, without gating. Returns { ok, satisfied, total, score, subscores, violations }, where `score` is satisfied/total in [0,1] (an empty intent scores 1); call it across edits to watch a plan approach the brief. The intent's shape is the `archlang://intent-schema` resource. A malformed intent returns `{ ok:false, intentErrors }` as data, never an exception.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"brief": {
"additionalProperties": {},
"description": "A brief's intent JSON (shape: the archlang://intent-schema resource) to measure against.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"source": {
"description": "ArchLang source.",
"type": "string"
}
},
"required": [
"source",
"brief"
],
"type": "object"
},
"name": "score",
"outputSchema": null
},
{
"description": "Suggest the doors and windows a plan's room graph needs, as data; nothing is applied. For a room with no path back, a building with no entrance, a bath reachable only through a bedroom, or a windowless bedroom, it returns ready-to-paste `door`/`window` statements with a rationale, for you to choose among and insert. Each names its wall by an authored id or a unique wall category, else by absolute `at (x, y)` coordinates. Door candidates avoid furniture in the door's approach; window candidates do not consider furniture.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"source": {
"description": "ArchLang source.",
"type": "string"
}
},
"required": [
"source"
],
"type": "object"
},
"name": "suggest",
"outputSchema": null
},
{
"description": "Check a plan in one pass without returning a drawing (parse, resolve and lint): the gate a plan passes before it ships. `strict:true` makes advisory warnings fail too. Optional `graph` checks the plan's interior-door adjacency against an intended room graph (`{ room: [neighbours] }`); a mismatch fails. Optional `intent` (a brief's expectations, shaped as the `archlang://intent-schema` resource describes) is checked against the plan: a missed gating assertion (room count, existence, area, total area, windows) fails, while adjacency and reachability are advisory and only score. `profile` lints under a named ruleset as well, and its warnings are the ones reported; `taste` scores the plan under a taste profile, which never fails it. `next` is the one item to fix first, chosen in a fixed order (an error, a compile warning, a validity warning, a drafting warning, the brief and the graph, a profile-only warning, then the lowest taste score), or null when nothing is left; a broken `soft` keep is not weighed here yet, so where the CLI's `validate` names it this returns a later item, or null. A malformed intent returns `{ ok:false, intentErrors }` and an unknown profile `{ ok:false, error }` as data, never an exception. Returns { ok, diagnostics, graph?, intent?, next }.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"graph": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"description": "Intended interior-door adjacency: { room: [neighbour rooms] }.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"intent": {
"additionalProperties": {},
"description": "A brief's intent JSON (shape: the archlang://intent-schema resource); gating assertions fail.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"profile": {
"description": "Advisory lint ruleset to report under (\"residential-basic\", \"accessibility-advisory\", …); default: the built-in ruleset.",
"type": "string"
},
"source": {
"description": "ArchLang source.",
"type": "string"
},
"strict": {
"description": "Advisory warnings fail too.",
"type": "boolean"
},
"taste": {
"description": "Taste profile that ranks `next`'s taste tier (for example \"generic\"); it never fails the plan.",
"type": "string"
}
},
"required": [
"source"
],
"type": "object"
},
"name": "validate",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c4b21c9ff396d75dc95020ff49c3ed944ad614fe9c7ad86db003da291455b670 | sha256sum