Skip to main content
Glama

Urban Game Theory — Consensus Builder

Edit shared plan

ugt_edit_shared_plan
Idempotent

Edit the private shared plan, or undo the last agent change with undoLastAgentChange. Inspect first and pass the current version and CID. Undo cannot be combined with content edits. The agent must hold the turn.

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": {
      "sessionId": "<sessionId>",
      "capability": "<capability>",
      "expectedVersion": "<expectedVersion>",
      "expectedCid": "<expectedCid>"
    },
    "name": "ugt_edit_shared_plan"
  }
}

Input Schema

NameRequiredDescriptionDefault
viewNo
whenNoOpen the preview at this month on the plan’s build-out time control.
titleNo
buildoutNoSeed of a simulated build-out: undated members (an urban rule parcel by parcel) get repeatable dates on the preview’s time control. Display only; never stored.
scheduleNoConstruction window per member: key = design CID or design ref, value = { start, end } months (YYYY-MM, inclusive) or null to clear. Windows are merged over the current ones and follow revised designs.
sessionIdYes
capabilityYes
operationsNo
expectedCidYes
expectedVersionYes
undoLastAgentChangeNo

Output Schema

NameRequiredDescriptionDefault
idYes
cidYes
urlNo
codeNo
nextNo
fieldNo
itemsNo
stageNo
totalNo
issuesNo
offsetNo
statusNo
valuesNo
canUndoYes
indexedNo
messageNo
versionYes
artifactYes
draftRefNo
warningsNo
expiresAtYes
retryableNo
truncatedNo
untrustedNo
updatedAtYes
controllerYes
currentCidNo
lastChangeYes
previewUrlNo
retryAfterNo
approvalUrlNo
constraintsNo
expectedCidNo
previousCidNo
publicationNo
previewStatusNo
publishedCidsNo
parcelSourceIdNo
previewExpiresAtNo
publicationApprovalYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / operations / items / oneOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "design": {
      -        "anyOf": [
      -          {
      -            "pattern": "^baf(?:krei|ybei)[a-z2-7]{52}$",
      -            "type": "string"
      -          },
      -          {
      -            "format": "uri",
      -            "maxLength": 300,
      -            "type": "string"
      -          },
      -          {
      -            "additionalProperties": {},
      -            "propertyNames": {
      -              "type": "string"
      -            },
      -            "type": "object"
      -          }
      -        ]
      -      },
      -      "displace": {
      -        "description": "Only after the person agrees: take the plan designs standing on this ground off the plan, as Apply does on the map. Without it such a placement is refused and lists them.",
      -        "type": "boolean"
      -      },
      -      "type": {
      -        "const": "add",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "design"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "ref": {
      -        "maxLength": 200,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "remove",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "ref"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "design": {
      -        "anyOf": [
      -          {
      -            "pattern": "^baf(?:krei|ybei)[a-z2-7]{52}$",
      -            "type": "string"
      -          },
      -          {
      -            "format": "uri",
      -            "maxLength": 300,
      -            "type": "string"
      -          },
      -          {
      -            "additionalProperties": {},
      -            "propertyNames": {
      -              "type": "string"
      -            },
      -            "type": "object"
      -          }
      -        ]
      -      },
      -      "displace": {
      -        "description": "Only after the person agrees: take the plan designs standing on this ground off the plan, as Apply does on the map. Without it such a placement is refused and lists them.",
      -        "type": "boolean"
      -      },
      -      "ref": {
      -        "maxLength": 200,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "replace",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "ref",
      -      "design"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "displace": {
      -        "description": "Only after the person agrees: take the plan designs standing on this ground off the plan, as Apply does on the map. Without it such a placement is refused and lists them.",
      -        "type": "boolean"
      -      },
      -      "edits": {
      -        "items": {
      -          "oneOf": [
      -            {
      -              "properties": {
      -                "op": {
      -                  "const": "add",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                },
      -                "value": {}
      -              },
      -              "required": [
      -                "op",
      -                "path",
      -                "value"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "op": {
      -                  "const": "replace",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                },
      -                "value": {}
      -              },
      -              "required": [
      -                "op",
      -                "path",
      -                "value"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "op": {
      -                  "const": "test",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                },
      -                "value": {}
      -              },
      -              "required": [
      -                "op",
      -                "path",
      -                "value"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "op": {
      -                  "const": "remove",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "op",
      -                "path"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "from": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                },
      -                "op": {
      -                  "const": "copy",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "op",
      -                "path",
      -                "from"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "from": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                },
      -                "op": {
      -                  "const": "move",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "op",
      -                "path",
      -                "from"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "degrees": {
      -                  "description": "Counterclockwise degrees; clockwise is negative.",
      -                  "maximum": 360,
      -                  "minimum": -360,
      -                  "type": "number"
      -                },
      -                "eastM": {
      -                  "maximum": 100000,
      -                  "minimum": -100000,
      -                  "type": "number"
      -                },
      -                "northM": {
      -                  "maximum": 100000,
      -                  "minimum": -100000,
      -                  "type": "number"
      -                },
      -                "op": {
      -                  "const": "transform",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                },
      -                "pivot": {
      -                  "items": false,
      -                  "maxItems": 2,
      -                  "minItems": 2,
      -                  "prefixItems": [
      -                    {
      -                      "maximum": 180,
      -                      "minimum": -180,
      -                      "type": "number"
      -                    },
      -                    {
      -                      "maximum": 85,
      -                      "minimum": -85,
      -                      "type": "number"
      -                    }
      -                  ],
      -                  "type": "array"
      -                },
      -                "scale": {
      -                  "maximum": 100,
      -                  "minimum": 0.01,
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "op",
      -                "path"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "from": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                },
      -                "op": {
      -                  "const": "union",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "op",
      -                "path",
      -                "from"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "from": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                },
      -                "op": {
      -                  "const": "difference",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "op",
      -                "path",
      -                "from"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "from": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                },
      -                "op": {
      -                  "const": "intersection",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "op",
      -                "path",
      -                "from"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "metres": {
      -                  "maximum": 1000,
      -                  "minimum": -1000,
      -                  "type": "number"
      -                },
      -                "op": {
      -                  "const": "buffer",
      -                  "type": "string"
      -                },
      -                "path": {
      -                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      -                  "maxLength": 1000,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "op",
      -                "path",
      -                "metres"
      -              ],
      -              "type": "object"
      -            }
      -          ]
      -        },
      -        "maxItems": 200,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "ref": {
      -        "maxLength": 200,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "edit",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "ref",
      -      "edits"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "changes": {
      -        "items": {
      -          "oneOf": [
      -            {
      -              "properties": {
      -                "type": {
      -                  "const": "retitle",
      -                  "type": "string"
      -                },
      -                "value": {
      -                  "maxLength": 200,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "value"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "type": {
      -                  "const": "redescribe",
      -                  "type": "string"
      -                },
      -                "value": {
      -                  "maxLength": 2000,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "value"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "metres": {
      -                  "exclusiveMinimum": 0,
      -                  "maximum": 100,
      -                  "type": "number"
      -                },
      -                "side": {
      -                  "enum": [
      -                    "north",
      -                    "south",
      -                    "east",
      -                    "west",
      -                    "both"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": {
      -                  "const": "widen",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "metres",
      -                "side"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "lanes": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "direction": {
      -                        "enum": [
      -                          "forward",
      -                          "backward",
      -                          "both"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      "gauge": {
      -                        "anyOf": [
      -                          {
      -                            "const": 1000,
      -                            "type": "number"
      -                          },
      -                          {
      -                            "const": 1435,
      -                            "type": "number"
      -                          }
      -                        ]
      -                      },
      -                      "landscape": {
      -                        "enum": [
      -                          "trees",
      -                          "grass"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      "type": {
      -                        "enum": [
      -                          "driving",
      -                          "bus",
      -                          "parking",
      -                          "parking_perpendicular",
      -                          "parking_angled",
      -                          "cycleway",
      -                          "sidewalk",
      -                          "verge",
      -                          "median",
      -                          "rail"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      "width": {
      -                        "maximum": 20,
      -                        "minimum": 0.25,
      -                        "type": "number"
      -                      }
      -                    },
      -                    "required": [
      -                      "type",
      -                      "width"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "maxItems": 32,
      -                  "minItems": 1,
      -                  "type": "array"
      -                },
      -                "preset": {
      -                  "enum": [
      -                    "2+2",
      -                    "1+1",
      -                    "1+1 with cycle lanes"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": {
      -                  "const": "set_profile",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "metres": {
      -                  "maximum": 100,
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                "toward": {
      -                  "enum": [
      -                    "north",
      -                    "south",
      -                    "east",
      -                    "west"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": {
      -                  "const": "shift",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "metres",
      -                "toward"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "kind": {
      -                  "enum": [
      -                    "driving",
      -                    "bus",
      -                    "parking",
      -                    "parking_perpendicular",
      -                    "parking_angled",
      -                    "cycleway",
      -                    "sidewalk",
      -                    "verge",
      -                    "median",
      -                    "rail"
      -                  ],
      -                  "type": "string"
      -                },
      -                "side": {
      -                  "enum": [
      -                    "north",
      -                    "south",
      -                    "east",
      -                    "west"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": {
      -                  "const": "add_lane",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "kind",
      -                "side"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "index": {
      -                  "maximum": 31,
      -                  "minimum": 0,
      -                  "type": "integer"
      -                },
      -                "type": {
      -                  "const": "remove_lane",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "index"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "buildingIndex": {
      -                  "description": "One building index in this immutable design; omit to edit every building.",
      -                  "maximum": 999,
      -                  "minimum": 0,
      -                  "type": "integer"
      -                },
      -                "floorHeightM": {
      -                  "maximum": 20,
      -                  "minimum": 0.5,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "set_floors",
      -                  "type": "string"
      -                },
      -                "value": {
      -                  "maximum": 200,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "value"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "buildingIndex": {
      -                  "description": "One building index in this immutable design; omit to edit every building.",
      -                  "maximum": 999,
      -                  "minimum": 0,
      -                  "type": "integer"
      -                },
      -                "floorHeightM": {
      -                  "maximum": 20,
      -                  "minimum": 0.5,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "set_height",
      -                  "type": "string"
      -                },
      -                "value": {
      -                  "exclusiveMinimum": 0,
      -                  "maximum": 800,
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "value"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "planningSource": {
      -                  "maxLength": 100,
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "type": {
      -                  "const": "fit_to_permitted",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "planningSource"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "buildingIndex": {
      -                  "description": "One building index in this immutable design; omit to edit every building.",
      -                  "maximum": 999,
      -                  "minimum": 0,
      -                  "type": "integer"
      -                },
      -                "type": {
      -                  "const": "set_use",
      -                  "type": "string"
      -                },
      -                "value": {
      -                  "description": "What the building is for: residential, residential-shops (shops on the ground floor), mixed (shops, offices on the first floor, flats above), office, public or industrial (frontend/js/building-use.js); a word naming one is read as it. On a Block, Row or Detached design it sets the rule's use for all its buildings (omit buildingIndex); a Block also takes automatic.",
      -                  "maxLength": 100,
      -                  "minLength": 1,
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "value"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "type": {
      -                  "const": "set_kind",
      -                  "type": "string"
      -                },
      -                "value": {
      -                  "enum": [
      -                    "park",
      -                    "square",
      -                    "lake"
      -                  ],
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "value"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "buildingIndex": {
      -                  "description": "One building index in this immutable design; omit to edit every building.",
      -                  "maximum": 999,
      -                  "minimum": 0,
      -                  "type": "integer"
      -                },
      -                "degrees": {
      -                  "maximum": 360,
      -                  "minimum": -360,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "rotate",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "degrees"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "buildingIndex": {
      -                  "description": "One building index in this immutable design; omit to edit every building.",
      -                  "maximum": 999,
      -                  "minimum": 0,
      -                  "type": "integer"
      -                },
      -                "eastM": {
      -                  "maximum": 100,
      -                  "minimum": -100,
      -                  "type": "number"
      -                },
      -                "northM": {
      -                  "maximum": 100,
      -                  "minimum": -100,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "move",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "eastM",
      -                "northM"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "buildingIndex": {
      -                  "maximum": 999,
      -                  "minimum": 0,
      -                  "type": "integer"
      -                },
      -                "type": {
      -                  "const": "remove_building",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "buildingIndex"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "count": {
      -                  "maximum": 500,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                },
      -                "spacingM": {
      -                  "maximum": 30,
      -                  "minimum": 1,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "add_trees",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "count"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "count": {
      -                  "maximum": 500,
      -                  "minimum": 0,
      -                  "type": "integer"
      -                },
      -                "spacingM": {
      -                  "maximum": 30,
      -                  "minimum": 1,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "set_tree_count",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "count"
      -              ],
      -              "type": "object"
      -            }
      -          ]
      -        },
      -        "maxItems": 20,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "displace": {
      -        "description": "Only after the person agrees: take the plan designs standing on this ground off the plan, as Apply does on the map. Without it such a placement is refused and lists them.",
      -        "type": "boolean"
      -      },
      -      "ref": {
      -        "maxLength": 200,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "modify",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "ref",
      -      "changes"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "design": {
      +        "anyOf": [
      +          {
      +            "pattern": "^baf(?:krei|ybei)[a-z2-7]{52}$",
      +            "type": "string"
      +          },
      +          {
      +            "format": "uri",
      +            "maxLength": 300,
      +            "type": "string"
      +          },
      +          {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "displace": {
      +        "description": "Only after the person agrees: take the plan designs standing on this ground off the plan, as Apply does on the map. Without it such a placement is refused and lists them.",
      +        "type": "boolean"
      +      },
      +      "type": {
      +        "const": "add",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "design"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "ref": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "remove",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "ref"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "design": {
      +        "anyOf": [
      +          {
      +            "pattern": "^baf(?:krei|ybei)[a-z2-7]{52}$",
      +            "type": "string"
      +          },
      +          {
      +            "format": "uri",
      +            "maxLength": 300,
      +            "type": "string"
      +          },
      +          {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "displace": {
      +        "description": "Only after the person agrees: take the plan designs standing on this ground off the plan, as Apply does on the map. Without it such a placement is refused and lists them.",
      +        "type": "boolean"
      +      },
      +      "ref": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "replace",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "ref",
      +      "design"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "displace": {
      +        "description": "Only after the person agrees: take the plan designs standing on this ground off the plan, as Apply does on the map. Without it such a placement is refused and lists them.",
      +        "type": "boolean"
      +      },
      +      "edits": {
      +        "items": {
      +          "oneOf": [
      +            {
      +              "properties": {
      +                "op": {
      +                  "const": "add",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                },
      +                "value": {}
      +              },
      +              "required": [
      +                "op",
      +                "path",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "op": {
      +                  "const": "replace",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                },
      +                "value": {}
      +              },
      +              "required": [
      +                "op",
      +                "path",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "op": {
      +                  "const": "test",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                },
      +                "value": {}
      +              },
      +              "required": [
      +                "op",
      +                "path",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "op": {
      +                  "const": "remove",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "op",
      +                "path"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "from": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                },
      +                "op": {
      +                  "const": "copy",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "op",
      +                "path",
      +                "from"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "from": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                },
      +                "op": {
      +                  "const": "move",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "op",
      +                "path",
      +                "from"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "degrees": {
      +                  "description": "Counterclockwise degrees; clockwise is negative.",
      +                  "maximum": 360,
      +                  "minimum": -360,
      +                  "type": "number"
      +                },
      +                "eastM": {
      +                  "maximum": 100000,
      +                  "minimum": -100000,
      +                  "type": "number"
      +                },
      +                "northM": {
      +                  "maximum": 100000,
      +                  "minimum": -100000,
      +                  "type": "number"
      +                },
      +                "op": {
      +                  "const": "transform",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                },
      +                "pivot": {
      +                  "items": false,
      +                  "maxItems": 2,
      +                  "minItems": 2,
      +                  "prefixItems": [
      +                    {
      +                      "maximum": 180,
      +                      "minimum": -180,
      +                      "type": "number"
      +                    },
      +                    {
      +                      "maximum": 85,
      +                      "minimum": -85,
      +                      "type": "number"
      +                    }
      +                  ],
      +                  "type": "array"
      +                },
      +                "scale": {
      +                  "maximum": 100,
      +                  "minimum": 0.01,
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "op",
      +                "path"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "from": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                },
      +                "op": {
      +                  "const": "union",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "op",
      +                "path",
      +                "from"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "from": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                },
      +                "op": {
      +                  "const": "difference",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "op",
      +                "path",
      +                "from"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "from": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                },
      +                "op": {
      +                  "const": "intersection",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "op",
      +                "path",
      +                "from"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "metres": {
      +                  "maximum": 1000,
      +                  "minimum": -1000,
      +                  "type": "number"
      +                },
      +                "op": {
      +                  "const": "buffer",
      +                  "type": "string"
      +                },
      +                "path": {
      +                  "description": "RFC 6901 JSON Pointer into canonical authored content; /geometry/buildings/0/properties/height for example.",
      +                  "maxLength": 1000,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "op",
      +                "path",
      +                "metres"
      +              ],
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "maxItems": 200,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "ref": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "edit",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "ref",
      +      "edits"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "changes": {
      +        "items": {
      +          "oneOf": [
      +            {
      +              "properties": {
      +                "type": {
      +                  "const": "retitle",
      +                  "type": "string"
      +                },
      +                "value": {
      +                  "maxLength": 200,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "type": {
      +                  "const": "redescribe",
      +                  "type": "string"
      +                },
      +                "value": {
      +                  "maxLength": 2000,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "metres": {
      +                  "exclusiveMinimum": 0,
      +                  "maximum": 100,
      +                  "type": "number"
      +                },
      +                "side": {
      +                  "enum": [
      +                    "north",
      +                    "south",
      +                    "east",
      +                    "west",
      +                    "both"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "widen",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "metres",
      +                "side"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "lanes": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "direction": {
      +                        "enum": [
      +                          "forward",
      +                          "backward",
      +                          "both"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "gauge": {
      +                        "anyOf": [
      +                          {
      +                            "const": 1000,
      +                            "type": "number"
      +                          },
      +                          {
      +                            "const": 1435,
      +                            "type": "number"
      +                          }
      +                        ]
      +                      },
      +                      "landscape": {
      +                        "enum": [
      +                          "trees",
      +                          "grass"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "type": {
      +                        "enum": [
      +                          "driving",
      +                          "bus",
      +                          "parking",
      +                          "parking_perpendicular",
      +                          "parking_angled",
      +                          "cycleway",
      +                          "sidewalk",
      +                          "verge",
      +                          "median",
      +                          "rail"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "width": {
      +                        "maximum": 20,
      +                        "minimum": 0.25,
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "type",
      +                      "width"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "maxItems": 32,
      +                  "minItems": 1,
      +                  "type": "array"
      +                },
      +                "preset": {
      +                  "enum": [
      +                    "2+2",
      +                    "1+1",
      +                    "1+1 with cycle lanes"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "set_profile",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "metres": {
      +                  "maximum": 100,
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                "toward": {
      +                  "enum": [
      +                    "north",
      +                    "south",
      +                    "east",
      +                    "west"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "shift",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "metres",
      +                "toward"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "kind": {
      +                  "enum": [
      +                    "driving",
      +                    "bus",
      +                    "parking",
      +                    "parking_perpendicular",
      +                    "parking_angled",
      +                    "cycleway",
      +                    "sidewalk",
      +                    "verge",
      +                    "median",
      +                    "rail"
      +                  ],
      +                  "type": "string"
      +                },
      +                "side": {
      +                  "enum": [
      +                    "north",
      +                    "south",
      +                    "east",
      +                    "west"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "add_lane",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "kind",
      +                "side"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "index": {
      +                  "maximum": 31,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "type": {
      +                  "const": "remove_lane",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "index"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "buildingIndex": {
      +                  "description": "One building index in this immutable design; omit to edit every building.",
      +                  "maximum": 999,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "floorHeightM": {
      +                  "maximum": 20,
      +                  "minimum": 0.5,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "set_floors",
      +                  "type": "string"
      +                },
      +                "value": {
      +                  "maximum": 200,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "buildingIndex": {
      +                  "description": "One building index in this immutable design; omit to edit every building.",
      +                  "maximum": 999,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "floorHeightM": {
      +                  "maximum": 20,
      +                  "minimum": 0.5,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "set_height",
      +                  "type": "string"
      +                },
      +                "value": {
      +                  "exclusiveMinimum": 0,
      +                  "maximum": 800,
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "planningSource": {
      +                  "maxLength": 100,
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "fit_to_permitted",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "planningSource"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "buildingIndex": {
      +                  "description": "One building index in this immutable design; omit to edit every building.",
      +                  "maximum": 999,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "type": {
      +                  "const": "set_use",
      +                  "type": "string"
      +                },
      +                "value": {
      +                  "description": "What the building is for: residential, residential-shops (shops on the ground floor), mixed (shops, offices on the first floor, flats above), office, public or industrial (frontend/js/building-use.js); a word naming one is read as it. On a Block, Row or Detached design it sets the rule's use for all its buildings (omit buildingIndex); a Block also takes automatic.",
      +                  "maxLength": 100,
      +                  "minLength": 1,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "buildingIndex": {
      +                  "description": "One building index in this immutable design; omit to edit every building.",
      +                  "maximum": 999,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "type": {
      +                  "const": "set_access",
      +                  "type": "string"
      +                },
      +                "value": {
      +                  "description": "How the building's suggested X-ray layout reaches the flats (frontend/js/building-use.js ACCESS): point (stair cores, two apartments each), corridor (a double-loaded corridor, flats on both sides) or auto (a corridor where the floor plate is 15 m deep or more). A Block, Row or Detached design keeps it on its rule, for all its buildings. On a rule design omit buildingIndex.",
      +                  "enum": [
      +                    "auto",
      +                    "point",
      +                    "corridor"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "type": {
      +                  "const": "set_kind",
      +                  "type": "string"
      +                },
      +                "value": {
      +                  "enum": [
      +                    "park",
      +                    "square",
      +                    "lake"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "buildingIndex": {
      +                  "description": "One building index in this immutable design; omit to edit every building.",
      +                  "maximum": 999,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "degrees": {
      +                  "maximum": 360,
      +                  "minimum": -360,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "rotate",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "degrees"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "buildingIndex": {
      +                  "description": "One building index in this immutable design; omit to edit every building.",
      +                  "maximum": 999,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "eastM": {
      +                  "maximum": 100,
      +                  "minimum": -100,
      +                  "type": "number"
      +                },
      +                "northM": {
      +                  "maximum": 100,
      +                  "minimum": -100,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "move",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "eastM",
      +                "northM"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "buildingIndex": {
      +                  "maximum": 999,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "type": {
      +                  "const": "remove_building",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "buildingIndex"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "count": {
      +                  "maximum": 500,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "spacingM": {
      +                  "maximum": 30,
      +                  "minimum": 1,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "add_trees",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "count"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "count": {
      +                  "maximum": 500,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "spacingM": {
      +                  "maximum": 30,
      +                  "minimum": 1,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "set_tree_count",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "count"
      +              ],
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "maxItems": 20,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "displace": {
      +        "description": "Only after the person agrees: take the plan designs standing on this ground off the plan, as Apply does on the map. Without it such a placement is refused and lists them.",
      +        "type": "boolean"
      +      },
      +      "ref": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "modify",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "ref",
      +      "changes"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Added

TDQS

A3.5/5.0
Behavior4/5

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

Beyond the annotations (readOnly=false, destructive=false, idempotent=true, openWorld=true) the description discloses an optimistic-concurrency contract via expectedVersion/expectedCid, the undo mutual exclusion, and a turn-ownership requirement. It leaves open what a stale version/CID actually returns, but the annotations already carry the safety profile.

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

Conciseness4/5

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

Four short sentences, with the core action and the undo alternative front-loaded and no filler. "The agent must hold the turn" is terse to the point of being opaque, but the text is otherwise tight.

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

Completeness2/5

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

For an 11-parameter tool with deeply nested objects and a large polymorphic operations union, the description is far too thin — the operation types (add/remove/replace/edit/modify) and displace behavior are never mentioned. An output schema exists, so return values needn't be covered, but the input-side complexity is largely unaddressed.

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

Parameters2/5

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

Schema description coverage is only 27% across 11 parameters, so the description carries the compensation burden. It only explains the concurrency pair ("current version and CID") and the undo flag, and says nothing about the operations array, schedule, buildout, view, or when — the parameters that actually shape the edit.

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?

The description states a specific verb and resource ("Edit the private shared plan") and names the second mode (undo via undoLastAgentChange). The qualifier "private shared plan" separates it from ugt_edit_plan and ugt_inspect_shared_plan, though no sibling is named explicitly.

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

Usage Guidelines4/5

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

It gives a concrete workflow prerequisite ("Inspect first and pass the current version and CID") and a hard exclusion ("Undo cannot be combined with content edits"), which tells the agent how to sequence calls. It does not, however, say when to prefer this over ugt_edit_plan or when to hand off to inspect_shared_plan.

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.