Skip to main content
Glama

Craft Quantities: construction material calculators

Edit a canvas drawing: move walls, add doors and windows

edit_drawing
Read-onlyIdempotent

Changes a Construction Canvas drawing (its link, its document or any form a new drawing takes) by simple edits through the canvas's own commands: move a wall (joined walls follow), set a length, add a door or window, set properties or type, remove, add, set a level; returns the drawing, its revision, the link, the diff and the quantities that changed. baseRev refuses a stale drawing. Not sized.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "operations": "<operations>"
    },
    "name": "edit_drawing"
  }
}

Input Schema

NameRequiredDescriptionDefault
langNoThe answer's language. en (the default): as ever. es or es-US: US Spanish — labels, units, result lines and the honest machine-translation label from the site's Spanish pages, Spanish words read in a question or a trade term, and links to the /es/ pages once the site publishes them (until then the links stay English). fr or fr-CA (Canadian French, /fr/) and pt or pt-BR (Brazilian Portuguese, /pt/): the same from the site's French and Portuguese pages, figures with a decimal comma; each link names the translated page only once that page is published, otherwise the English page.en
linkNoA Construction Canvas drawing link (https://craftquantities.com/construction-canvas/#d=…, as the engine and the canvas's Share give it), or its code.
detailNofull (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.full
systemNoThe system lengths are read in and the quantities listed in (both are listed); default the drawing's own.metric
baseRevNoThe revision the edits are meant for (a rev or baseRev an earlier answer gave). When the drawing sent is not that revision (somebody changed it since), the request is refused with 409 and nothing is applied, as an If-Match.
drawingNoA drawing in any form the engine draws from: house, commands, document, shapes, layout or template.
documentNoA Construction Canvas document (schema 1 to the canvas's current), opened by the canvas's own opener. Its JSON Schema: https://craftquantities.com/schemas/canvas-drawing-5.json.
inputUnitsNoSend "base" to pass bare numbers on dimensioned inputs in base units (m, m², L, kg …), as the published test vectors are written. Without it a length, area or volume must carry its unit.
operationsYesThe edits, in order, each through the canvas's own commands. One that the canvas refuses refuses the whole request, with every problem: nothing is half-applied.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed9 schema fields changed
    • addedInput schema / properties / baseRev
      Added value: +{
      +  "description": "The revision the edits are meant for (a rev or baseRev an earlier answer gave). When the drawing sent is not that revision (somebody changed it since), the request is refused with 409 and nothing is applied, as an If-Match.",
      +  "pattern": "^[0-9a-f]{16}$",
      +  "type": "string"
      +}
    • changedInput schema / properties / document / description
      Previous value: -"A Construction Canvas document (schema 1 to the canvas's current), opened by the canvas's own opener."New value: +"A Construction Canvas document (schema 1 to the canvas's current), opened by the canvas's own opener. Its JSON Schema: https://craftquantities.com/schemas/canvas-drawing-5.json."
    • addedInput schema / properties / operations / items / properties / elevation
      Added value: +{
      +  "description": "set_level: the level's floor elevation.",
      +  "oneOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "maxLength": 200,
      +      "type": "string"
      +    },
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "unit": {
      +          "maxLength": 40,
      +          "type": "string"
      +        },
      +        "value": {
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "value"
      +      ],
      +      "type": "object"
      +    }
      +  ]
      +}
    • addedInput schema / properties / operations / items / properties / height
      Added value: +{
      +  "description": "set_level: the level's floor-to-floor height.",
      +  "oneOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "maxLength": 200,
      +      "type": "string"
      +    },
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "unit": {
      +          "maxLength": 40,
      +          "type": "string"
      +        },
      +        "value": {
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "value"
      +      ],
      +      "type": "object"
      +    }
      +  ]
      +}
    • addedInput schema / properties / operations / items / properties / level
      Added value: +{
      +  "description": "set_level: the level, by its name or id.",
      +  "maxLength": 60,
      +  "type": "string"
      +}
    • addedInput schema / properties / operations / items / properties / name
      Added value: +{
      +  "description": "set_level: the level's new name.",
      +  "maxLength": 60,
      +  "type": "string"
      +}
    • changedInput schema / properties / operations / items / properties / op / description
      Previous value: -"move: an object by a vector or a direction and distance (a wall's joined walls follow); set_length: a wall's length; add_opening: a door or window in a wall; set: properties; set_type: the build-up type; remove: an object and its openings; add: one drawing command, as a new drawing takes it."New value: +"move: an object by a vector or a direction and distance (a wall's joined walls follow); set_length: a wall's length; add_opening: a door or window in a wall; set: properties; set_type: the build-up type; remove: an object and its openings; add: one drawing command, as a new drawing takes it (a level, a room, a wall …); set_level: a level's name, elevation or height."
    • changedInput schema / properties / operations / items / properties / op / enum
      Previous value: -[
      -  "move",
      -  "set_length",
      -  "add_opening",
      -  "set",
      -  "set_type",
      -  "remove",
      -  "add"
      -]New value: +[
      +  "move",
      +  "set_length",
      +  "add_opening",
      +  "set",
      +  "set_type",
      +  "remove",
      +  "add",
      +  "set_level"
      +]
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "citation": {
      -        "properties": {
      -          "accessDate": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "author": {
      -            "type": "string"
      -          },
      -          "formats": {
      -            "properties": {
      -              "apa": {
      -                "type": "string"
      -              },
      -              "bibtex": {
      -                "type": "string"
      -              },
      -              "harvard": {
      -                "type": "string"
      -              },
      -              "plain": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "plain",
      -              "apa",
      -              "harvard",
      -              "bibtex"
      -            ],
      -            "type": "object"
      -          },
      -          "sourcesChecked": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "title": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "type": "string"
      -          },
      -          "version": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          }
      -        },
      -        "required": [
      -          "author",
      -          "title",
      -          "url",
      -          "formats",
      -          "accessDate"
      -        ],
      -        "type": "object"
      -      },
      -      "codeLength": {
      -        "type": "integer"
      -      },
      -      "counts": {
      -        "required": [
      -          "objects",
      -          "levels"
      -        ],
      -        "type": "object"
      -      },
      -      "diff": {
      -        "properties": {
      -          "added": {
      -            "items": {
      -              "required": [
      -                "id",
      -                "c"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "changed": {
      -            "items": {
      -              "required": [
      -                "id",
      -                "c",
      -                "fields"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "removed": {
      -            "items": {
      -              "required": [
      -                "id",
      -                "c"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "added",
      -          "removed",
      -          "changed"
      -        ],
      -        "type": "object"
      -      },
      -      "document": {
      -        "description": "The edited drawing: send it (or the link) back to edit it again.",
      -        "required": [
      -          "schema",
      -          "units",
      -          "counters",
      -          "levels",
      -          "types",
      -          "entities",
      -          "assumed",
      -          "updatedAt"
      -        ],
      -        "type": "object"
      -      },
      -      "doors": {
      -        "description": "Every door's hand: the wall end its leaf hangs at (start or end, from the wall's start) and the face it opens toward (left or right going start to end, y up on plan). stored false: the drawing holds no hand for it, and the canvas draws it hinged at its start, opening left.",
      -        "items": {
      -          "properties": {
      -            "hinge": {
      -              "enum": [
      -                "start",
      -                "end"
      -              ]
      -            },
      -            "id": {
      -              "type": "string"
      -            },
      -            "stored": {
      -              "type": "boolean"
      -            },
      -            "swing": {
      -              "enum": [
      -                "left",
      -                "right"
      -              ]
      -            },
      -            "wall": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "id",
      -            "wall",
      -            "hinge",
      -            "swing",
      -            "stored"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "engine": {
      -        "type": "object"
      -      },
      -      "from": {
      -        "description": "What the drawing arrived as: link, document, or the form of a new drawing (house, commands, template …).",
      -        "type": "string"
      -      },
      -      "language": {
      -        "description": "Only with a lang other than en: the answer's language (es-US, fr-CA or pt-BR), whether its links may name the translated pages (spanishLinks for es-US; localeLinks for fr-CA and pt-BR, where an unpublished page still links in English), and the honest machine-translation label.",
      -        "properties": {
      -          "englishPages": {
      -            "description": "Site page addresses in this answer that open the ENGLISH page, because the translated page is not published yet (the words in the answer may still be translated).",
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "label": {
      -            "type": "object"
      -          },
      -          "lang": {
      -            "enum": [
      -              "es-US",
      -              "fr-CA",
      -              "pt-BR"
      -            ]
      -          },
      -          "localeLinks": {
      -            "type": "boolean"
      -          },
      -          "note": {
      -            "type": "string"
      -          },
      -          "spanishLinks": {
      -            "type": "boolean"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "licence": {
      -        "properties": {
      -          "attribution": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "name",
      -          "url",
      -          "attribution"
      -        ],
      -        "type": "object"
      -      },
      -      "link": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Opens the edited drawing on the canvas as a new project's; null when too large for a link."
      -      },
      -      "links": {
      -        "required": [
      -          "canvas",
      -          "drawing",
      -          "page"
      -        ],
      -        "type": "object"
      -      },
      -      "note": {
      -        "type": "string"
      -      },
      -      "notice": {
      -        "type": "string"
      -      },
      -      "quantities": {
      -        "properties": {
      -          "changed": {
      -            "description": "The canvas dock's rows whose quantity moved (null: the row is new, or gone), in both unit systems.",
      -            "items": {
      -              "properties": {
      -                "after": {
      -                  "anyOf": [
      -                    {
      -                      "type": "number"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "before": {
      -                  "anyOf": [
      -                    {
      -                      "type": "number"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "calculator": {
      -                  "type": "string"
      -                },
      -                "change": {
      -                  "anyOf": [
      -                    {
      -                      "type": "number"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "key": {
      -                  "type": "string"
      -                },
      -                "label": {
      -                  "type": "string"
      -                },
      -                "otherSystem": {
      -                  "anyOf": [
      -                    {
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "section": {
      -                  "type": "string"
      -                },
      -                "unit": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "key",
      -                "section",
      -                "label",
      -                "unit",
      -                "before",
      -                "after",
      -                "change",
      -                "otherSystem",
      -                "calculator"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "labourHours": {
      -            "description": "The labour band the canvas gives the drawing, before and after: hours for planning, not a price.",
      -            "properties": {
      -              "after": {
      -                "properties": {
      -                  "high": {
      -                    "type": "number"
      -                  },
      -                  "likely": {
      -                    "type": "number"
      -                  },
      -                  "low": {
      -                    "type": "number"
      -                  }
      -                },
      -                "required": [
      -                  "low",
      -                  "likely",
      -                  "high"
      -                ],
      -                "type": "object"
      -              },
      -              "before": {
      -                "properties": {
      -                  "high": {
      -                    "type": "number"
      -                  },
      -                  "likely": {
      -                    "type": "number"
      -                  },
      -                  "low": {
      -                    "type": "number"
      -                  }
      -                },
      -                "required": [
      -                  "low",
      -                  "likely",
      -                  "high"
      -                ],
      -                "type": "object"
      -              }
      -            },
      -            "required": [
      -              "before",
      -              "after"
      -            ],
      -            "type": "object"
      -          },
      -          "unchanged": {
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "changed",
      -          "unchanged",
      -          "labourHours"
      -        ],
      -        "type": "object"
      -      },
      -      "schema": {
      -        "description": "The canvas document schema the edited drawing is in.",
      -        "type": "integer"
      -      },
      -      "steps": {
      -        "description": "What each operation did, as the canvas says it.",
      -        "items": {
      -          "properties": {
      -            "index": {
      -              "type": "integer"
      -            },
      -            "op": {
      -              "type": "string"
      -            },
      -            "said": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "index",
      -            "op",
      -            "said"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "system": {
      -        "enum": [
      -          "metric",
      -          "imperial"
      -        ]
      -      },
      -      "tooLong": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "engine",
      -      "system",
      -      "from",
      -      "steps",
      -      "diff",
      -      "quantities",
      -      "counts",
      -      "schema",
      -      "document",
      -      "link",
      -      "codeLength",
      -      "note",
      -      "links",
      -      "citation",
      -      "licence",
      -      "notice"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "citation": {
      -        "description": "The one citation line, built from the answer's own data.",
      -        "type": "string"
      -      },
      -      "detail": {
      -        "const": "summary"
      -      },
      -      "language": {
      -        "description": "Only with a lang other than en: the answer's language (es-US, fr-CA or pt-BR), whether its links may name the translated pages (spanishLinks for es-US; localeLinks for fr-CA and pt-BR, where an unpublished page still links in English), and the honest machine-translation label.",
      -        "properties": {
      -          "englishPages": {
      -            "description": "Site page addresses in this answer that open the ENGLISH page, because the translated page is not published yet (the words in the answer may still be translated).",
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "label": {
      -            "type": "object"
      -          },
      -          "lang": {
      -            "enum": [
      -              "es-US",
      -              "fr-CA",
      -              "pt-BR"
      -            ]
      -          },
      -          "localeLinks": {
      -            "type": "boolean"
      -          },
      -          "note": {
      -            "type": "string"
      -          },
      -          "spanishLinks": {
      -            "type": "boolean"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "lines": {
      -        "description": "The result lines, as the report's table gives them.",
      -        "items": {
      -          "additionalProperties": {
      -            "type": "string"
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "more": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "notes": {
      -        "description": "What a professional must decide, when to call one, a false-friend warning, that adoption is local: kept in every summary.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "open": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "tool": {
      -        "type": "string"
      -      },
      -      "url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "detail",
      -      "tool",
      -      "title",
      -      "lines",
      -      "notes",
      -      "citation",
      -      "url",
      -      "open",
      -      "more"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "baseRev": {
      +        "description": "The revision of the drawing the edits were applied to.",
      +        "type": "string"
      +      },
      +      "citation": {
      +        "properties": {
      +          "accessDate": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "author": {
      +            "type": "string"
      +          },
      +          "formats": {
      +            "properties": {
      +              "apa": {
      +                "type": "string"
      +              },
      +              "bibtex": {
      +                "type": "string"
      +              },
      +              "harvard": {
      +                "type": "string"
      +              },
      +              "plain": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "plain",
      +              "apa",
      +              "harvard",
      +              "bibtex"
      +            ],
      +            "type": "object"
      +          },
      +          "sourcesChecked": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "title": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          },
      +          "version": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "author",
      +          "title",
      +          "url",
      +          "formats",
      +          "accessDate"
      +        ],
      +        "type": "object"
      +      },
      +      "codeLength": {
      +        "type": "integer"
      +      },
      +      "counts": {
      +        "required": [
      +          "objects",
      +          "levels"
      +        ],
      +        "type": "object"
      +      },
      +      "diff": {
      +        "properties": {
      +          "added": {
      +            "items": {
      +              "required": [
      +                "id",
      +                "c"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "changed": {
      +            "items": {
      +              "required": [
      +                "id",
      +                "c",
      +                "fields"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "removed": {
      +            "items": {
      +              "required": [
      +                "id",
      +                "c"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "added",
      +          "removed",
      +          "changed"
      +        ],
      +        "type": "object"
      +      },
      +      "document": {
      +        "description": "The edited drawing (JSON Schema: https://craftquantities.com/schemas/canvas-drawing-5.json): send it (or the link) back to edit it again.",
      +        "required": [
      +          "schema",
      +          "units",
      +          "counters",
      +          "levels",
      +          "types",
      +          "entities",
      +          "assumed",
      +          "updatedAt"
      +        ],
      +        "type": "object"
      +      },
      +      "documentSchema": {
      +        "description": "The JSON Schema the document follows.",
      +        "type": "string"
      +      },
      +      "doors": {
      +        "description": "Every door's hand: the wall end its leaf hangs at (start or end, from the wall's start) and the face it opens toward (left or right going start to end, y up on plan). stored false: the drawing holds no hand for it, and the canvas draws it hinged at its start, opening left.",
      +        "items": {
      +          "properties": {
      +            "hinge": {
      +              "enum": [
      +                "start",
      +                "end"
      +              ]
      +            },
      +            "id": {
      +              "type": "string"
      +            },
      +            "stored": {
      +              "type": "boolean"
      +            },
      +            "swing": {
      +              "enum": [
      +                "left",
      +                "right"
      +              ]
      +            },
      +            "wall": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "id",
      +            "wall",
      +            "hinge",
      +            "swing",
      +            "stored"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "engine": {
      +        "type": "object"
      +      },
      +      "from": {
      +        "description": "What the drawing arrived as: link, document, or the form of a new drawing (house, commands, template …).",
      +        "type": "string"
      +      },
      +      "language": {
      +        "description": "Only with a lang other than en: the answer's language (es-US, fr-CA or pt-BR), whether its links may name the translated pages (spanishLinks for es-US; localeLinks for fr-CA and pt-BR, where an unpublished page still links in English), and the honest machine-translation label.",
      +        "properties": {
      +          "englishPages": {
      +            "description": "Site page addresses in this answer that open the ENGLISH page, because the translated page is not published yet (the words in the answer may still be translated).",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "label": {
      +            "type": "object"
      +          },
      +          "lang": {
      +            "enum": [
      +              "es-US",
      +              "fr-CA",
      +              "pt-BR"
      +            ]
      +          },
      +          "localeLinks": {
      +            "type": "boolean"
      +          },
      +          "note": {
      +            "type": "string"
      +          },
      +          "spanishLinks": {
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "licence": {
      +        "properties": {
      +          "attribution": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "url",
      +          "attribution"
      +        ],
      +        "type": "object"
      +      },
      +      "link": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Opens the edited drawing on the canvas as a new project's; null when too large for a link."
      +      },
      +      "links": {
      +        "required": [
      +          "canvas",
      +          "drawing",
      +          "page"
      +        ],
      +        "type": "object"
      +      },
      +      "note": {
      +        "type": "string"
      +      },
      +      "notice": {
      +        "type": "string"
      +      },
      +      "quantities": {
      +        "properties": {
      +          "changed": {
      +            "description": "The canvas dock's rows whose quantity moved (null: the row is new, or gone), in both unit systems.",
      +            "items": {
      +              "properties": {
      +                "after": {
      +                  "anyOf": [
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "before": {
      +                  "anyOf": [
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "calculator": {
      +                  "type": "string"
      +                },
      +                "change": {
      +                  "anyOf": [
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "key": {
      +                  "type": "string"
      +                },
      +                "label": {
      +                  "type": "string"
      +                },
      +                "otherSystem": {
      +                  "anyOf": [
      +                    {
      +                      "type": "object"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "section": {
      +                  "type": "string"
      +                },
      +                "unit": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "key",
      +                "section",
      +                "label",
      +                "unit",
      +                "before",
      +                "after",
      +                "change",
      +                "otherSystem",
      +                "calculator"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "labourHours": {
      +            "description": "The labour band the canvas gives the drawing, before and after: hours for planning, not a price.",
      +            "properties": {
      +              "after": {
      +                "properties": {
      +                  "high": {
      +                    "type": "number"
      +                  },
      +                  "likely": {
      +                    "type": "number"
      +                  },
      +                  "low": {
      +                    "type": "number"
      +                  }
      +                },
      +                "required": [
      +                  "low",
      +                  "likely",
      +                  "high"
      +                ],
      +                "type": "object"
      +              },
      +              "before": {
      +                "properties": {
      +                  "high": {
      +                    "type": "number"
      +                  },
      +                  "likely": {
      +                    "type": "number"
      +                  },
      +                  "low": {
      +                    "type": "number"
      +                  }
      +                },
      +                "required": [
      +                  "low",
      +                  "likely",
      +                  "high"
      +                ],
      +                "type": "object"
      +              }
      +            },
      +            "required": [
      +              "before",
      +              "after"
      +            ],
      +            "type": "object"
      +          },
      +          "unchanged": {
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "changed",
      +          "unchanged",
      +          "labourHours"
      +        ],
      +        "type": "object"
      +      },
      +      "rev": {
      +        "description": "The edited drawing's revision: send it as baseRev with the next edit, so an edit to a drawing changed meanwhile is refused rather than written over the change.",
      +        "type": "string"
      +      },
      +      "schema": {
      +        "description": "The canvas document schema the edited drawing is in.",
      +        "type": "integer"
      +      },
      +      "steps": {
      +        "description": "What each operation did, as the canvas says it.",
      +        "items": {
      +          "properties": {
      +            "index": {
      +              "type": "integer"
      +            },
      +            "op": {
      +              "type": "string"
      +            },
      +            "said": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "index",
      +            "op",
      +            "said"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "system": {
      +        "enum": [
      +          "metric",
      +          "imperial"
      +        ]
      +      },
      +      "tooLong": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "engine",
      +      "system",
      +      "from",
      +      "steps",
      +      "diff",
      +      "quantities",
      +      "counts",
      +      "schema",
      +      "baseRev",
      +      "rev",
      +      "documentSchema",
      +      "document",
      +      "link",
      +      "codeLength",
      +      "note",
      +      "links",
      +      "citation",
      +      "licence",
      +      "notice"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "citation": {
      +        "description": "The one citation line, built from the answer's own data.",
      +        "type": "string"
      +      },
      +      "detail": {
      +        "const": "summary"
      +      },
      +      "language": {
      +        "description": "Only with a lang other than en: the answer's language (es-US, fr-CA or pt-BR), whether its links may name the translated pages (spanishLinks for es-US; localeLinks for fr-CA and pt-BR, where an unpublished page still links in English), and the honest machine-translation label.",
      +        "properties": {
      +          "englishPages": {
      +            "description": "Site page addresses in this answer that open the ENGLISH page, because the translated page is not published yet (the words in the answer may still be translated).",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "label": {
      +            "type": "object"
      +          },
      +          "lang": {
      +            "enum": [
      +              "es-US",
      +              "fr-CA",
      +              "pt-BR"
      +            ]
      +          },
      +          "localeLinks": {
      +            "type": "boolean"
      +          },
      +          "note": {
      +            "type": "string"
      +          },
      +          "spanishLinks": {
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "lines": {
      +        "description": "The result lines, as the report's table gives them.",
      +        "items": {
      +          "additionalProperties": {
      +            "type": "string"
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "more": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "notes": {
      +        "description": "What a professional must decide, when to call one, a false-friend warning, that adoption is local: kept in every summary.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "open": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "tool": {
      +        "type": "string"
      +      },
      +      "url": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "detail",
      +      "tool",
      +      "title",
      +      "lines",
      +      "notes",
      +      "citation",
      +      "url",
      +      "open",
      +      "more"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Added

TDQS

C2.9/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description repeatedly asserts mutation: it "Changes a Construction Canvas drawing", applies edits, and returns "its revision" and "the diff". Annotations declare readOnlyHint=true and destructiveHint=false, directly contradicting the stated behavior. Despite otherwise useful detail (joined walls follow, baseRev If-Match refusal, all-or-nothing application), the safety profile the agent reads from annotations is the opposite of what the prose claims.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded, which is good, but the body is one semicolon-chained sentence that mixes scope, operation list, return values and the baseRev rule. The parenthetical "(its link, its document or any form a new drawing takes)" is opaque, and the trailing fragment "Not sized." conveys little while costing a clause.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a very large nested schema with an output schema, the description covers input forms, the edit vocabulary, concurrency via baseRev and atomicity. What it leaves unresolved is the most important question — whether the edit is persisted — because the readOnly annotation conflicts with the prose, and it says nothing about permissions or how objects are discovered before being targeted.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description echoes the operations enum (move, set_length, add_opening, set, set_type, remove, add, set_level) and mentions baseRev's stale-revision refusal, but adds no syntax, unit or targeting detail beyond what the schema already documents.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Changes a Construction Canvas drawing ... by simple edits through the canvas's own commands" gives a specific verb and resource, then enumerates the concrete edits (move a wall, set a length, add a door or window, remove, add, set a level) and the return payload. It is unmistakably distinct from create_drawing in practice, but it never names a sibling or states the boundary explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: the description presupposes an existing drawing (given by link, document, commands, shapes, layout or template) and warns that a stale baseRev is refused with 409. There is no explicit statement of when to pick this over create_drawing or a house/layout creation path, and no prerequisites such as permissions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources