immobilier

Generate a dimensioned DXF drawing

cao_generer_dxf

Read-only

WHEN the drawing must leave as a real CAD file, openable by an architect or a draughtsman. Draw a building scene and get an AutoCAD DXF. Call cao_verifier first to catch geometry mistakes. Scene schema: GET https://synergieloc.fr/api/v1/cao/schema. Returns a JSON object {dxf, faces, entites_2d, unites, note}: the whole DXF drawing arrives INLINE as text in dxf — there is no download URL and no file stored on the server, so write it to a .dxf file yourself. faces and entites_2d count what was produced, unites states the drawing unit. alertes[] lists geometry issues still standing. Choose cao_generer_ifc instead when the recipient needs BIM objects rather than lines.

Input Schema

TableJSON Schema

Name	Required	Description
`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[].
`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"
+}

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

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

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.7/5.0

Behavior5/5

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

Goes well beyond the readOnly/openWorld annotation trio by disclosing delivery semantics: the DXF arrives INLINE as text, there is no download URL and no file on the server, so the caller must persist it. It also names the alertes[] channel for unresolved geometry issues — exactly the operational context an agent cannot infer.

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?

Front-loaded with the WHEN clause before any mechanics, and every sentence is load-bearing: condition, action, prerequisite, schema pointer, return shape, alternative. No restatement of the name or title.

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?

For a 12-parameter, deeply nested scene tool with no output schema, the description supplies the missing return contract (dxf/faces/entites_2d/unites/note/alertes), the inline-delivery caveat, a prerequisite, and an escape hatch to the sibling. Nothing an agent needs to invoke it correctly is absent.

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% and the nested murs/boites/plan/etc. properties are richly documented, so the schema carries parameter meaning. The description adds no parameter-level detail (units, frames, defaults), so the baseline 3 for high-coverage schemas is correct.

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+resource ('Draw a building scene and get an AutoCAD DXF') and explicitly distinguishes itself from the sibling cao_generer_ifc by output type (lines vs BIM objects). An agent can route between the two CAD generators without opening either schema.

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?

Opens with a clear WHEN condition ('the drawing must leave as a real CAD file'), gives a prerequisite ('Call cao_verifier first to catch geometry mistakes'), and names the alternative and its selecting condition ('Choose cao_generer_ifc instead when the recipient needs BIM objects'). When, prerequisite and alternative are all explicit.

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?