Skip to main content
Glama

Edit reinforcement

edit_reinforcement
DestructiveIdempotent

Changes one reinforcement laying moddl made (guid: its bar set, or any mat of a mat laying). Name only the keys that change, as create_reinforcement names them; moddl merges them into the stored input (Moddl_Bewehrung.Eingabe), lays the laying anew from it and writes the input back, one revision. A bar set keeps its GlobalId and position; type values follow the diameter, a type shared with other sets is cloned. Mats are removed and laid anew: reinforcement_edit.mats lists removed and created. Layings laid against it (gaps in its gaps, corners in its links, next_layer at its face, stud rails measuring d from it) follow in the same revision (reinforcement_relaid); one that no longer fits stays as it was, named in reinforcement_warnings. Refused: a key of another rule (detail.allowed), reinforcement without stored input (not laid by moddl). Diameter, spacing or count of a laying change here, not with set_dimension. New revision, effect report. A call that succeeds is not a job that's done. The report's reinforcement_edit: changed {key, before, after}, n_before -> n_after bars or mats, laid as create_reinforcement echoes it.

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": {
      "guid": "<guid>"
    },
    "name": "edit_reinforcement"
  }
}

Input Schema

NameRequiredDescriptionDefault
atNobars: outer box corner [s,t,h]
endNostirrups: s limit
bondNobars, layer, stirrups, opening, mesh: bond condition; left out read from the bars in the host cast upward (Fig. 8.2) - name it at precast parts
endsNobars (points), layer: as create_reinforcement; replaces the stored ends whole, a support read anew
faceNolayer, opening, corners, mesh: host side
guidYesA bar set or one mat of the laying (find_elements class IfcReinforcingBar, IfcReinforcingMesh)
legsNobars: outer dimensions
meshNomesh: stock mesh name
normNobars, layer, stirrups, opening: norm of its lengths (compute_quantities AnchorageLength, LapLength), mesh: of its laps; left out EN 1992-1-1 recommended values; under the NA its gaps are safe-side assumptions (alpha_ct 0.85), mats lap only as named
noteNoYour note, stored with the new revision
countNolayer, stirrups: instead of spacing (remove spacing); opening: per edge; corners
coverNom, bar surface to the host faces; or per side as create_reinforcement
hooksNobars: [start, end] 0, 90, 135, 180
pitchNostirrups in a circle: helix pitch m
planeNobars: frame axes [u, v]
shapeNobars: with legs, at, plane
startNostirrups: s of the first
zonesNostirrups: zones along s as create_reinforcement; replaces the stored list whole, remove spacing or count first
pointsNobars: axis polyline [[s,t,h],...] of the first bar
regionNolayer, mesh: part of the face; gaps: gaps chosen, bar run
removeNoKeys taken out of the stored input: back to their default, or spacing to name count
dry_runNoPreview: the planned effect, nothing written
mandrelNom; remove it for the EN 1992-1-1 minimum
spacingNolayer, stirrups, opening: m
diameterNobars, layer, stirrups, opening, gaps: m
cut_facesNobars, layer, gaps, opening: host sides where the model is cut, as create_reinforcement; replaces the stored list whole, remove ["cut_faces"] drops it
directionNolayer, opening: bar axis; mesh: longitudinal wires
lap_shareNobars, layer, stirrups: share of bars lapped at one place, 0 to 1 (alpha6); left out the largest alpha6
distributeNobars: replaces the stored one whole
next_layerNolayer: against the sets at face
request_idNoYour id for this call: a repeat answers the first result and writes nothing
shape_codeNobars: BendingShapeCode; named anew (or removed) with a new shape or points
hook_lengthNobars, stirrups
region_fromNolayer: the hull of an element on the face, as create_reinforcement; replaces the stored one whole
steel_gradeNobars, layer, stirrups, opening, gaps: IfcMaterial (B500B), the set takes it
layer_offsetNolayer, opening: m further in
stock_lengthNobars (straight), layer: delivered bar length; longer bars become pieces lapped by l0 (LapLength at the share laid), neighbours staggered (report split); refused where l0 lacks
edge_distanceNomesh: m
concrete_classNobars, layer, stirrups, opening, mesh: class of EN 1992-1-1 Tab. 3.1 (C30/37) where the host states none; one differing from its StrengthClass is refused
continues_intoNobars, stirrups: concrete the bars run on into, as create_reinforcement; replaces the stored list whole, remove ["continues_into"] drops it
lap_transverseNomesh: m
lap_longitudinalNomesh: m
steel_stress_mpaNobars, layer, stirrups, opening, mesh: sigma_sd in MPa; left out fyd of steel_grade (B500, assumption); above fyd refused

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • changedInput schema / properties / continues_into / description
      Previous value: -"bars, stirrups: concrete the bars run on into, as create_elements; replaces the stored list whole, remove [\"continues_into\"] drops it"New value: +"bars, stirrups: concrete the bars run on into, as create_reinforcement; replaces the stored list whole, remove [\"continues_into\"] drops it"
    • addedInput schema / properties / cover / anyOf
      Added value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "properties": {
      +      "+h": {
      +        "description": "m",
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "+s": {
      +        "description": "m",
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "+t": {
      +        "description": "m",
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "-h": {
      +        "description": "m",
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "-s": {
      +        "description": "m",
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "-t": {
      +        "description": "m",
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "default": {
      +        "description": "m",
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / cover / description
      Previous value: -"m, bar surface to the host faces"New value: +"m, bar surface to the host faces; or per side as create_reinforcement"
    • removedInput schema / properties / cover / type
      Removed value: -"number"
    • changedInput schema / properties / cut_faces / description
      Previous value: -"bars, layer, gaps, opening: host sides where the model is cut, as create_elements; replaces the stored list whole, remove [\"cut_faces\"] drops it"New value: +"bars, layer, gaps, opening: host sides where the model is cut, as create_reinforcement; replaces the stored list whole, remove [\"cut_faces\"] drops it"
    • addedInput schema / properties / ends
      Added value: +{
      +  "description": "bars (points), layer: as create_reinforcement; replaces the stored ends whole, a support read anew",
      +  "properties": {
      +    "end": {
      +      "description": "last point; layer: upper",
      +      "properties": {
      +        "beyond": {
      +          "anyOf": [
      +            {
      +              "const": "lbd",
      +              "type": "string"
      +            },
      +            {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "pattern": "^\\s*-?[\\d.,]+\\s*(mm|cm|dm|m|km)\\s*$",
      +                  "type": "string"
      +                }
      +              ],
      +              "description": "Metres as a number, or a text with unit: 300 mm, 1,20 m"
      +            }
      +          ],
      +          "description": "support: past its edge, lbd (AnchorageLength) or m"
      +        },
      +        "face": {
      +          "description": "face: the host side this end points to",
      +          "enum": [
      +            "+s",
      +            "-s",
      +            "+t",
      +            "-t",
      +            "+h",
      +            "-h"
      +          ],
      +          "type": "string"
      +        },
      +        "support": {
      +          "description": "support: what the host rests on (find_supports)",
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "to": {
      +          "description": "what the end is laid at",
      +          "enum": [
      +            "face",
      +            "support"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "to"
      +      ],
      +      "type": "object"
      +    },
      +    "start": {
      +      "description": "first point; layer: lower along direction",
      +      "properties": {
      +        "beyond": {
      +          "anyOf": [
      +            {
      +              "const": "lbd",
      +              "type": "string"
      +            },
      +            {
      +              "anyOf": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "pattern": "^\\s*-?[\\d.,]+\\s*(mm|cm|dm|m|km)\\s*$",
      +                  "type": "string"
      +                }
      +              ],
      +              "description": "Metres as a number, or a text with unit: 300 mm, 1,20 m"
      +            }
      +          ],
      +          "description": "support: past its edge, lbd (AnchorageLength) or m"
      +        },
      +        "face": {
      +          "description": "face: the host side this end points to",
      +          "enum": [
      +            "+s",
      +            "-s",
      +            "+t",
      +            "-t",
      +            "+h",
      +            "-h"
      +          ],
      +          "type": "string"
      +        },
      +        "support": {
      +          "description": "support: what the host rests on (find_supports)",
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "to": {
      +          "description": "what the end is laid at",
      +          "enum": [
      +            "face",
      +            "support"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "to"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
    • changedInput schema / properties / region / description
      Previous value: -"mesh: part of the face; gaps: gaps chosen, bar run"New value: +"layer, mesh: part of the face; gaps: gaps chosen, bar run"
    • changedInput schema / properties / region / properties / h / description
      Previous value: -"[lo, hi] frame m"New value: +"[lo, hi] frame m along this axis"
    • changedInput schema / properties / region / properties / s / description
      Previous value: -"[lo, hi] frame m"New value: +"[lo, hi] frame m along this axis"
    • changedInput schema / properties / region / properties / t / description
      Previous value: -"[lo, hi] frame m"New value: +"[lo, hi] frame m along this axis"
    • addedInput schema / properties / region_from
      Added value: +{
      +  "description": "layer: the hull of an element on the face, as create_reinforcement; replaces the stored one whole",
      +  "properties": {
      +    "element": {
      +      "description": "GlobalId of the element (a wall under a slab) whose hull in the host frame is the region",
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "margin": {
      +      "anyOf": [
      +        {
      +          "type": "number"
      +        },
      +        {
      +          "pattern": "^\\s*-?[\\d.,]+\\s*(mm|cm|dm|m|km)\\s*$",
      +          "type": "string"
      +        }
      +      ],
      +      "description": "m added on each side of the hull"
      +    }
      +  },
      +  "required": [
      +    "element",
      +    "margin"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / zones
      Added value: +{
      +  "description": "stirrups: zones along s as create_reinforcement; replaces the stored list whole, remove spacing or count first",
      +  "items": {
      +    "properties": {
      +      "end": {
      +        "description": "s of the zone end, frame m",
      +        "type": "number"
      +      },
      +      "spacing": {
      +        "anyOf": [
      +          {
      +            "type": "number"
      +          },
      +          {
      +            "pattern": "^\\s*-?[\\d.,]+\\s*(mm|cm|dm|m|km)\\s*$",
      +            "type": "string"
      +          }
      +        ],
      +        "description": "Metres as a number, or a text with unit: 300 mm, 1,20 m"
      +      }
      +    },
      +    "required": [
      +      "end",
      +      "spacing"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 20,
      +  "minItems": 1,
      +  "type": "array"
      +}
  2. Changed5 schema fields changed
    • addedInput schema / properties / continues_into
      Added value: +{
      +  "description": "bars, stirrups: concrete the bars run on into, as create_elements; replaces the stored list whole, remove [\"continues_into\"] drops it",
      +  "items": {
      +    "description": "IFC GlobalId",
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 8,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / properties / cut_faces
      Added value: +{
      +  "description": "bars, layer, gaps, opening: host sides where the model is cut, as create_elements; replaces the stored list whole, remove [\"cut_faces\"] drops it",
      +  "items": {
      +    "enum": [
      +      "+s",
      +      "-s",
      +      "+t",
      +      "-t",
      +      "+h",
      +      "-h"
      +    ],
      +    "type": "string"
      +  },
      +  "maxItems": 6,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / properties / diameter / description
      Previous value: -"bars, layer, stirrups, opening: m"New value: +"bars, layer, stirrups, opening, gaps: m"
    • changedInput schema / properties / region / description
      Previous value: -"mesh: part of the face"New value: +"mesh: part of the face; gaps: gaps chosen, bar run"
    • changedInput schema / properties / steel_grade / description
      Previous value: -"bars, layer, stirrups, opening: IfcMaterial (B500B), the set takes it"New value: +"bars, layer, stirrups, opening, gaps: IfcMaterial (B500B), the set takes it"
  3. Added

TDQS

A4.5/5.0
Behavior4/5

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

Goes well beyond the annotations: discloses that bar sets keep their GlobalId and position, that a type shared with other sets is cloned, that mats are removed and re-laid, that dependent layings (gaps, corners, next_layer, stud rails) are relaid in the same revision with non-fitting ones left intact and named in reinforcement_warnings, and that the call produces a new revision plus an effect report. Only the idempotency mechanism is deferred to the schema's request_id rather than stated here.

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?

Front-loaded with the action and free of filler, but the prose is extremely telegraphic and packed into a few dense run-on sentences ('New revision, effect report. A call that succeeds is not a job that's done.'). The final sentence is cryptic and the sequence of guarantees, subordinate edits, and refusals is hard to parse on first read.

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

Completeness5/5

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

No output schema exists, and the description compensates by outlining the report shape (reinforcement_edit: changed {key, before, after}, n_before -> n_after) and the reinforcement_relaid / reinforcement_warnings side channels. For a destructive, 43-parameter mutation tool it covers refusals, cascading effects, revision semantics and return content.

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

Parameters4/5

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

Schema coverage is 100%, so per-parameter detail is already carried by the schema; the description's added value is the merge model ('name only the keys that change ... moddl merges them into the stored input') and whole-list-replacement semantics, which govern how all 43 parameters are interpreted. That is real meaning beyond the schema, though it stops short of explaining the dry_run or remove interactions.

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

Purpose5/5

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

States a specific verb and resource with exact scope: 'Changes one reinforcement laying moddl made (guid: its bar set, or any mat of a mat laying).' It is immediately distinguishable from create_reinforcement (which names the keys initially) and from set_dimension, which the description explicitly says is the wrong tool for changing diameter, spacing or count.

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

Usage Guidelines5/5

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

Gives positive guidance (name only the keys that change, as create_reinforcement names them), a negative routing rule ('Diameter, spacing or count of a laying change here, not with set_dimension'), and refusal conditions (a key of another rule, reinforcement without stored input / not laid by moddl). The agent knows both when to call it and when it will be rejected.

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