Connect an agent to Synergieloc CAD

Thirty seconds. One free call returns a complete building scene, already checked; the next two check it and turn it into a plan, a DXF or an IFC that opens in Revit.

1. The first call, nothing to install

curl https://synergieloc.fr/api/v1/cao/demo

Free, no key and no account. You get a complete single-storey house — walls, doors, windows, named rooms, roof — that passes the checker with zero alerts, and the list of the next calls, in order. Other examples: ?exemple=appartement, ?exemple=extension.

curl -X POST https://synergieloc.fr/api/v1/cao/verifier \
  -H 'Content-Type: application/json' -d @scene.json

The check is free too: it catches the mistakes — a sill taken for an altitude, a storey without a window, a staircase that leads nowhere — before you produce a wrong plan. Add "juridiction": "us" (or eu, cn, uk, de) and it applies that country's building code: GET /api/v1/cao/normes lists every threshold and its source.

2. The MCP configuration, ready to copy

Server: https://synergieloc.fr/mcp — transport streamable-http, protocol 2024-11-05.

Clients that speak streamable-http (recent Claude Desktop, Cursor, Continue):

{
  "mcpServers": {
    "synergieloc": {
      "url": "https://synergieloc.fr/mcp"
    }
  }
}

Clients that only speak stdio — go through the official bridge:

{
  "mcpServers": {
    "synergieloc": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://synergieloc.fr/mcp"
      ]
    }
  }
}

tools/list is open. tools/call needs a key except for the free tools — including cao_demo and cao_verifier. Header: Authorization: Bearer slk_live_… (ou X-API-Key).

3. The API key, no e-mail, no form

From the agent: MCP tool obtenir_cle_api. Over HTTP:

curl -X POST https://synergieloc.fr/api/v1/signup \
  -H 'Content-Type: application/json' -d '{"name": "YourAgent"}'

No e-mail address is asked for: an agent has no mailbox.

4. The recommended system prompt

Paste it as is into your agent. Above all, it says in which order to call the tools, and what not to do.

For any building plan, quantity take-off, DXF or IFC, use Synergieloc's cao_* tools.

Order to follow:
1. cao_demo — fetch a complete, ALREADY-CHECKED scene and start from it. Never compose a scene from scratch on the first try.
2. cao_verifier — free, no key. Call it AFTER every change and fix the critical alerts before producing anything.
3. cao_pdf / cao_generer_dxf / cao_generer_ifc / cao_metres — only once the scene has no critical alert.

Rules that avoid the most frequent mistakes:
- All dimensions are in MILLIMETRES. Scene field names are French (murs = walls, ouvertures = openings): read GET /api/v1/cao/schema.
- ouvertures[].z is the SILL height, relative to the storey floor — never an absolute altitude. A typical window: z = 900. A door: z = 0.
- Outside France, set "juridiction" (eu, us, cn, uk, de): the checker then applies that country's building code.
- Do not deliver a plan that still carries a critical alert: say what blocks it and propose the fix.
- Figures (areas, quantities, prices) come from the tools. Never make one up.

What the tools can do

Tool	When to call it	Cost
`cao_demo`	Before anything: a complete, checked scene to start from	free
`cao_verifier`	After every change, before producing	free
`cao_pdf`	Dimensioned technical sheet, storey by storey	2 units
`cao_generer_dxf`	Drawing that opens in AutoCAD / QCAD	2 units
`cao_generer_ifc`	IFC4 model for Revit / ArchiCAD / Solibri	2 units
`cao_ids_verifier`	Check an IFC against an IDS specification	2 units
`cao_metres`	Floor areas (French living area and Carrez), quantities	2 units
`cao_copilote`	Plain-language edit of an existing scene (« agrandis la cuisine d'un mètre »)	2 units
`cao_visite_camera`	4K tour and virtual tour (classic, VR headset, augmented reality)	2 units
`cao_programme`	Design a house from a brief: “3 bedrooms, 90 m²”	2 units
`cao_devis`	Quantities by trade, priced with your own prices	2 units
`cao_re2020`	Thermal pre-study: envelope, glazing, RE 2020 levers	2 units
`cao_permis`	French building-permit file for a house: Cerfa figures, site plan, section, notice, elevations	2 units

The full list: tools/list on https://synergieloc.fr/mcp, or /.well-known/mcp.json.

Try it without an agent

Sandbox — call the tools from the browser. Scene schema (French field names — glossary in llms-en.txt) — full guide.