Skip to main content
Glama
assoujojo82-coder

synergieloc — French Real-Estate Legal Calculations

cao_metres

Compute construction quantities from a CAD scene to price jobs, order materials, or verify quotes. Returns geometry audit alerts so critical issues are fixed before estimating.

Instructions

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
planNo2D reference lines
boitesNoBoxes (furniture, volumes): center x,y + dims l,p,h (mm)
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`).

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.1.1

TDQS

A4.1/5.0
Behavior4/5

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

With no annotations, the description carries the full behavioral burden. It discloses that the tool returns both computed quantities and alertes[] from a geometry audit, and warns that critical alerts should be resolved before quoting. It does not detail every output aspect or side-effect profile, but for a compute/read-style tool this is substantial useful disclosure.

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 front-loaded sentences, each earning its place: the WHEN trigger, the core computation, the alertes warning, and the scene compatibility note. No filler or redundant restatement of the tool name.

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

Completeness3/5

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

The description covers selection criteria and the fact that alertes[] are returned, but there is no output schema and the description does not specify what quantity fields are returned or their units. For a 10-parameter tool with no output schema, that is a moderate gap, though parameter coverage is strong.

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 input schema already explains each parameter thoroughly. The description adds scene-level context ('Same scene as cao_generer_dxf') but no parameter-level semantics beyond what the schema provides, so the baseline of 3 applies.

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?

The description uses a specific verb+resource pair: 'Compute quantities (metrés) from a CAO scene' and attaches concrete business triggers ('price a job, order materials, or check a quote'). It also distinguishes itself from CAO siblings by mentioning the geometry audit alertes and the shared 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?

It clearly states when to use the tool (pricing, material ordering, quote checking) and even gives workflow guidance ('fix critical alerts before quoting'). It names the same-scene relationship with cao_generer_dxf, but it does not explicitly say which sibling tools NOT to use or provide formal alternatives/exclusions.

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