immobilier

Render a plan or 3D view image

cao_rendu

Read-only

WHEN you want to SEE the plan before delivering it — a quick visual check that the scene is what you meant. Top-down preview of a CAO scene. Prefer cao_verifier before this for structured alerts; use the preview to visually double-check. Returns the picture itself, never a link: format=svg gives SVG markup as text, format=png gives an MCP image you can look at directly. Read-only — nothing is drawn, saved or sent anywhere.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`murs`	No	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.
`plan`	No	2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks.
`boites`	No	Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[].
`format`	No	svg (default) returns editable vector markup as text — best when you want to inspect or post-process it. png returns a raster image you can actually see. These two values are the only ones accepted; anything else is refused.	svg
`georef`	No	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.
`cercles`	No	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.
`reseaux`	No	Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type).
`toitures`	No	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.
`plomberie`	No	Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite.
`decoration`	No	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).
`ouvertures`	No	Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres.
`electricite`	No	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`).
`compositions`	No	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.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 15, 2026

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"
+}

Changed1 schema field changedSep 14, 2026

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"
+]

Changed5 schema fields changedSep 13, 2026

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"
+}

Changed23 schema fields changedSep 12, 2026

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 / format / description

Previous value: -"Format de l'image rendue : png ou jpeg."New value: +"svg (default) returns editable vector markup as text — best when you want to inspect or post-process it. png returns a raster image you can actually see. These two values are the only ones accepted; anything else is refused."

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[]"
```

Changed5 schema fields changedSep 7, 2026

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[]"
```

addedInput schema / properties / format / description

Added value: +"Format de l'image rendue : png ou jpeg."

Changed6 schema fields changedJul 24, 2026

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"
+}

AddedJul 15, 2026

TDQS

A4.1/5.0

Behavior4/5

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

Annotations already declare readOnlyHint/destructiveHint/openWorld, but the description adds genuinely new behavioral facts: the render is returned inline and 'never a link', the two formats differ in output kind (SVG markup as text vs an inspectable MCP image), and nothing is drawn, saved or sent. The 'read-only' sentence partly restates the annotation, but the output-format behavior is real added context.

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?

The WHEN clause is front-loaded and the four short sentences each carry information (purpose, ordering vs verifier, return format, safety). The em-dash aside ('a quick visual check that the scene is what you meant') is slightly conversational filler, so it is efficient rather than maximally tight.

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?

For a render tool whose scene schema is fully self-documented at 100% coverage, the description covers what an agent needs for selection and invocation: purpose, ordering relative to cao_verifier, and the carve-out that the image is returned inline. No output schema exists, but the two possible return kinds are explained, which closes the main gap.

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 13 scene parameters in depth; baseline is 3. The description contributes a small amount of extra meaning for format (svg = editable text, png = raster image) beyond the schema's enum descriptions, but says nothing about the murs/plan/boites/georef parameters it will be called with.

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 states a specific verb and resource — a top-down preview render of a CAO scene for a quick visual check — and explicitly distinguishes itself from the sibling cao_verifier ('Prefer cao_verifier before this for structured alerts'). An agent can tell what this produces (an image, not a report) without opening the schema.

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 clear triggering context ('WHEN you want to SEE the plan before delivering it') and names an alternative with a selection rule (cao_verifier first, this second for visual double-checking). It stops short of explicit when-not-to-use guidance (e.g., when cao_pdf or cao_visite_plan is the right render target), which keeps it from a 5.

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

All immobilier tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?