Singular House

Transforme les plans d’un architecte en maison 3D que vous pouvez visiter, puis laisse votre IA y choisir les finitions, les meubles et les produits, et voir combien cela coûte. Chaque modification attend votre accord.

Serveur MCP hébergé

npx add-mcp 'https://house.singular-labs.ai/mcp/house'

S’installe dans Claude Code, Codex, Cursor et plus

Documentation

The Singular House MCP server for AI agents: how an AI app or agent connects, makes and works on your house with Singular House, and what it can and cannot do.

What it is

Singular House turns an architect's plans into a 3D model of the house that you can walk through, then lets you choose finishes, furniture and products on it and see what they cost. Your AI app works it for you through one MCP server, signed in as you: it makes a new house and works on the houses you have.

Connect

Tell your AI: I want to create a house with Singular House. An AI that can run commands connects itself with curl -fsSL https://house.singular-labs.ai/install | sh (Windows: irm https://house.singular-labs.ai/install.ps1 | iex). Instructions every AI can read are at /llms.txt.

Connect with a link and a code. Any AI that can make web requests connects itself: it sends POST https://house.singular-labs.ai/mcp/connect with {"client_name": "Claude on my laptop", "email": "you@example.com"} (the email is optional) and gets back a link and a short code like BCDF-GHJK. It gives you both. You open the link, sign in, check the page shows the code your AI shows, and tap Allow or Deny. Meanwhile it asks POST https://house.singular-labs.ai/mcp/connect/token with its device_code every few seconds and gets its token once you allow (the OAuth device authorization grant, RFC 8628). The token is listed on Your houses, where you can revoke it.

To add it by hand, add a connector (a remote MCP server, streamable HTTP) with this address: https://house.singular-labs.ai/mcp/house. Your AI app signs you in with your Singular Labs account (OAuth; you can make an account on the sign-in page). An app that asks for a client ID uses dbd6880963d1c665585b, with no secret; others register themselves.

Make a house

start_house starts a draft by its name. set_location places it on the map. add_file adds a plan or photo: a small file inline, or a one-time link that sends a large one straight to the draft; describe_plan says what a plan is, remove_file takes one out. note_question keeps what the AI asked you and your answer. get_draft reads drafts. finish_house shows what would be made, and create_house makes the house, only after you say yes to that summary.

Work on a house

list_houses lists the houses you may open; every other tool names one. Read the choices, the catalog of products and what changed (list_choices, get_choice, list_catalog, get_product, product_preview, list_changes, list_checkpoints). Propose changes: add a product from a store link or a photo (add_product, followed with product_status), make and edit choices and their options (create_choice, add_option, pick_option, close_choice and the like), save or restore a checkpoint of the whole house.

Nothing changes without your yes

Every change the AI proposes comes back as a pending change, with a plain summary and pictures of before and after. The AI shows them to you; only approve_change, after you say yes, puts it in your house, and reject_change drops it. A pending change you never answer expires after a day. No tool deletes a choice or an option, and every change can be taken back.

What it cannot do

The tools reach only your houses and the ones shared with you, in the role you were given. They cannot read or change files, run code, or reach other addresses. A product whose 3D model does not look like the real one is reported as a miss, not put in your house.