Skip to main content
Glama

Compute quantities (areas, lengths, volumes)

cao_metres
Read-only

WHEN you need FIGURES from a design — to price a job, order materials, or check a quote. Compute quantities (metrés) from a CAO scene. Also returns alertes[] from the geometry audit — fix critical alerts before quoting. Same scene as cao_generer_dxf.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
mursNoWalls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you.
planNo2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks.
boitesNoBoxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[].
georefNoOptional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise.
cerclesNoCircles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes.
reseauxNoPlumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type).
toituresNoRoofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof.
plomberieNoSanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite.
decorationNoPaint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid).
ouverturesNoDoors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres.
electriciteNoElectrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`).
compositionsNoNamed wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / murs / items / properties / existant
      Added value: +{
      +  "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add.",
      +  "type": "boolean"
      +}
  2. Changed1 schema field changed
    • changedInput schema / properties / plomberie / items / properties / type / enum
      Previous value: -[
      -  "baignoire",
      -  "chauffe_eau",
      -  "compteur_eau",
      -  "douche",
      -  "evier",
      -  "lavabo",
      -  "radiateur",
      -  "wc"
      -]New value: +[
      +  "baignoire",
      +  "chauffe_eau",
      +  "compteur_eau",
      +  "douche",
      +  "evier",
      +  "lavabo",
      +  "module_hydraulique",
      +  "pac_exterieure",
      +  "radiateur",
      +  "wc"
      +]
  3. Changed5 schema fields changed
    • addedInput schema / properties / compositions
      Added value: +{
      +  "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer.",
      +  "type": "object"
      +}
    • addedInput schema / properties / georef
      Added value: +{
      +  "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise.",
      +  "properties": {
      +    "altitude": {
      +      "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93).",
      +      "type": "number"
      +    },
      +    "crs": {
      +      "description": "Projected CRS name. Default EPSG:2154 (Lambert-93).",
      +      "type": "string"
      +    },
      +    "est": {
      +      "description": "Easting in metres in the CRS. Omit if unknown — never invent.",
      +      "type": "number"
      +    },
      +    "nord": {
      +      "description": "Northing in metres in the CRS. Omit if unknown — never invent.",
      +      "type": "number"
      +    },
      +    "orientation": {
      +      "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0.",
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / murs / items / properties / composition
      Added value: +{
      +  "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC.",
      +  "type": "string"
      +}
    • addedInput schema / properties / murs / items / properties / couches
      Added value: +{
      +  "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness.",
      +  "type": "array"
      +}
    • addedInput schema / properties / murs / items / properties / materiau
      Added value: +{
      +  "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition.",
      +  "type": "string"
      +}
  4. Changed22 schema fields changed
    • changedInput schema / properties / boites / description
      Previous value: -"Boxes (furniture, volumes): center x,y + dims l,p,h (mm)"New value: +"Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    • addedInput schema / properties / boites / items / properties / h / description
      Added value: +"Height along Z (mm)"
    • addedInput schema / properties / boites / items / properties / l / description
      Added value: +"Length along X before rotation (mm)"
    • addedInput schema / properties / boites / items / properties / p / description
      Added value: +"Depth along Y before rotation (mm)"
    • addedInput schema / properties / boites / items / properties / rotation / description
      Added value: +"Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
    • addedInput schema / properties / boites / items / properties / x / description
      Added value: +"Centre X of the box (mm) — not a corner"
    • addedInput schema / properties / boites / items / properties / y / description
      Added value: +"Centre Y of the box (mm) — not a corner"
    • addedInput schema / properties / boites / items / properties / z / description
      Added value: +"Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
    • changedInput schema / properties / murs / description
      Previous value: -"Walls: plan segments extruded vertically"New value: +"Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    • addedInput schema / properties / murs / items / properties / epaisseur / description
      Added value: +"Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
    • addedInput schema / properties / murs / items / properties / hauteur / description
      Added value: +"Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
    • addedInput schema / properties / murs / items / properties / x1 / description
      Added value: +"Start point X of the wall axis (mm)"
    • addedInput schema / properties / murs / items / properties / x2 / description
      Added value: +"End point X of the wall axis (mm)"
    • addedInput schema / properties / murs / items / properties / y1 / description
      Added value: +"Start point Y of the wall axis (mm)"
    • addedInput schema / properties / murs / items / properties / y2 / description
      Added value: +"End point Y of the wall axis (mm)"
    • addedInput schema / properties / ouvertures / items / properties / hauteur / description
      Added value: +"Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
    • addedInput schema / properties / ouvertures / items / properties / largeur / description
      Added value: +"Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
    • changedInput schema / properties / plan / description
      Previous value: -"2D reference lines"New value: +"2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    • addedInput schema / properties / plan / items / properties / x1 / description
      Added value: +"Start X (mm), same frame as murs[]"
    • addedInput schema / properties / plan / items / properties / x2 / description
      Added value: +"End X (mm), same frame as murs[]"
    • addedInput schema / properties / plan / items / properties / y1 / description
      Added value: +"Start Y (mm), same frame as murs[]"
    • addedInput schema / properties / plan / items / properties / y2 / description
      Added value: +"End Y (mm), same frame as murs[]"
  5. Changed4 schema fields changed
    • addedInput schema / properties / cercles / description
      Added value: +"Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    • addedInput schema / properties / cercles / items / properties / r / description
      Added value: +"Radius, same unit as plan[]"
    • addedInput schema / properties / cercles / items / properties / x / description
      Added value: +"Centre X, same unit as plan[]"
    • addedInput schema / properties / cercles / items / properties / y / description
      Added value: +"Centre Y, same unit as plan[]"
  6. Changed6 schema fields changed
    • addedInput schema / properties / decoration
      Added value: +{
      +  "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid).",
      +  "items": {
      +    "properties": {
      +      "couleur": {
      +        "description": "Hex color, e.g. '#e2e0d5' — default per type",
      +        "type": "string"
      +      },
      +      "face": {
      +        "default": "interieur",
      +        "enum": [
      +          "interieur",
      +          "exterieur"
      +        ],
      +        "type": "string"
      +      },
      +      "finition": {
      +        "description": "Informational only, doesn't affect rendering",
      +        "enum": [
      +          "mat",
      +          "satin",
      +          "brillant",
      +          "structure"
      +        ],
      +        "type": "string"
      +      },
      +      "mur": {
      +        "description": "Index in murs[]",
      +        "type": "integer"
      +      },
      +      "type": {
      +        "default": "peinture",
      +        "enum": [
      +          "beton_cire",
      +          "carrelage_mural",
      +          "enduit",
      +          "lambris",
      +          "papier_peint",
      +          "peinture"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "mur"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / electricite
      Added value: +{
      +  "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`).",
      +  "items": {
      +    "properties": {
      +      "mur": {
      +        "type": "integer"
      +      },
      +      "position": {
      +        "type": "number"
      +      },
      +      "type": {
      +        "default": "prise",
      +        "enum": [
      +          "detecteur_fumee",
      +          "interrupteur",
      +          "luminaire",
      +          "prise",
      +          "prise_rj45",
      +          "prise_spe",
      +          "tableau_electrique",
      +          "va_et_vient",
      +          "vmc"
      +        ],
      +        "type": "string"
      +      },
      +      "x": {
      +        "type": "number"
      +      },
      +      "y": {
      +        "type": "number"
      +      },
      +      "z": {
      +        "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)",
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / ouvertures
      Added value: +{
      +  "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres.",
      +  "items": {
      +    "properties": {
      +      "hauteur": {
      +        "type": "number"
      +      },
      +      "largeur": {
      +        "type": "number"
      +      },
      +      "mur": {
      +        "description": "Index of the host wall in murs[] (0-based)",
      +        "type": "integer"
      +      },
      +      "position": {
      +        "description": "Distance in mm from the wall's start (x1,y1)",
      +        "type": "number"
      +      },
      +      "type": {
      +        "default": "fenetre",
      +        "enum": [
      +          "fenetre",
      +          "porte"
      +        ],
      +        "type": "string"
      +      },
      +      "z": {
      +        "description": "Sill height (mm) — default 900 (window) or 0 (door)",
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "mur",
      +      "position",
      +      "largeur",
      +      "hauteur"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / plomberie
      Added value: +{
      +  "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite.",
      +  "items": {
      +    "properties": {
      +      "h": {
      +        "type": "number"
      +      },
      +      "l": {
      +        "type": "number"
      +      },
      +      "mur": {
      +        "type": "integer"
      +      },
      +      "p": {
      +        "type": "number"
      +      },
      +      "position": {
      +        "type": "number"
      +      },
      +      "rotation": {
      +        "default": 0,
      +        "type": "number"
      +      },
      +      "type": {
      +        "default": "evier",
      +        "enum": [
      +          "baignoire",
      +          "chauffe_eau",
      +          "compteur_eau",
      +          "douche",
      +          "evier",
      +          "lavabo",
      +          "radiateur",
      +          "wc"
      +        ],
      +        "type": "string"
      +      },
      +      "x": {
      +        "type": "number"
      +      },
      +      "y": {
      +        "type": "number"
      +      },
      +      "z": {
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / reseaux
      Added value: +{
      +  "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type).",
      +  "items": {
      +    "properties": {
      +      "diametre": {
      +        "description": "mm, default per type",
      +        "type": "number"
      +      },
      +      "trace": {
      +        "description": "At least 2 points (mm), freely drawn in plan",
      +        "items": {
      +          "properties": {
      +            "x": {
      +              "type": "number"
      +            },
      +            "y": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "type": {
      +        "default": "ef",
      +        "enum": [
      +          "ef",
      +          "ec",
      +          "eu",
      +          "ev",
      +          "ep",
      +          "chauffage"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "trace"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / toitures
      Added value: +{
      +  "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof.",
      +  "items": {
      +    "properties": {
      +      "apex": {
      +        "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)",
      +        "properties": {
      +          "x": {
      +            "type": "number"
      +          },
      +          "y": {
      +            "type": "number"
      +          },
      +          "z": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "debord": {
      +        "default": 200,
      +        "description": "Eaves overhang (mm) on the auto footprint",
      +        "type": "number"
      +      },
      +      "epaisseur": {
      +        "default": 180,
      +        "description": "Slab thickness (mm) — 'plat' only",
      +        "type": "number"
      +      },
      +      "hauteur": {
      +        "description": "'chien_assis' only: front wall height, default 900",
      +        "type": "number"
      +      },
      +      "hauteur_faitage": {
      +        "default": 1200,
      +        "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'",
      +        "type": "number"
      +      },
      +      "largeur": {
      +        "description": "'chien_assis' only, default 1000",
      +        "type": "number"
      +      },
      +      "murs": {
      +        "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given.",
      +        "items": {
      +          "type": "integer"
      +        },
      +        "type": "array"
      +      },
      +      "polygone": {
      +        "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'.",
      +        "items": {
      +          "properties": {
      +            "x": {
      +              "type": "number"
      +            },
      +            "y": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "profondeur": {
      +        "description": "'chien_assis' only, default 800",
      +        "type": "number"
      +      },
      +      "rayon": {
      +        "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)",
      +        "type": "number"
      +      },
      +      "rotation": {
      +        "default": 0,
      +        "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)",
      +        "type": "number"
      +      },
      +      "segments": {
      +        "default": 16,
      +        "description": "Facet count — 'conique'/'dome'",
      +        "type": "integer"
      +      },
      +      "type": {
      +        "default": "plat",
      +        "enum": [
      +          "chien_assis",
      +          "conique",
      +          "deux_pans",
      +          "dome",
      +          "personnalise",
      +          "plat",
      +          "quatre_pans"
      +        ],
      +        "type": "string"
      +      },
      +      "x": {
      +        "description": "'chien_assis' only: center x",
      +        "type": "number"
      +      },
      +      "y": {
      +        "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope",
      +        "type": "number"
      +      },
      +      "z": {
      +        "description": "Base altitude (mm) — default: top of the walls covered",
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  7. Added

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already declare a safe read-only, non-destructive, closed-world profile, so the bar is lower. The description adds genuinely new behavioral context: it returns alertes[] from a geometry audit and warns to resolve critical alerts before quoting, plus notes it operates on the same scene as cao_generer_dxf. It does not describe return shape beyond the alerts array, but for a read-only tool this is solid.

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

Conciseness5/5

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

Three short sentences, front-loaded with the use-case condition followed by the action and the key caveat. Every sentence carries information and none is wasted.

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

Completeness4/5

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

With no output schema, the description helpfully discloses one return element (alertes[]). It does not enumerate the actual quantity outputs (areas/lengths/volumes appear only in the title) or note that only murs/boites are counted, so it is slightly incomplete for a rich 12-parameter tool, but adequate overall.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents all 12 scene parameters in detail (units, frames, defaults). The description adds no additional parameter meaning, so the baseline of 3 is appropriate.

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 ('Compute quantities (métres) from a CAO scene') and frames the outcome with a purpose clause ('FIGURES from a design — to price a job, order materials, or check a quote'). It also distinguishes itself from the sibling it shares a scene with (cao_generer_dxf).

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?

Opens with an explicit WHEN clause tying the tool to pricing/materials/quote-checking, and adds a critical-alert prerequisite ('fix critical alerts before quoting'). It clarifies its relation to cao_generer_dxf but does not name a genuine alternative tool to use instead in other situations, so it stops short of a 5.

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