---
name: singular-house
description: Create, design or change a house with Singular House (house.singular-labs.ai) for the person. Use when they want to make a 3D model of their house from an architect's plans, walk through it, choose finishes and furniture, add a product, or mention Singular House at all.
---

# Singular House

Singular House turns an architect's plans into a 3D house the person can walk through, then lets them choose
finishes, furniture and products on it. You work it for them through one MCP server, `singular-house`
(https://house.singular-labs.ai/mcp/house): it makes a house and works on it.

If its tools are not loaded in this session, call the same tools through the command line in this conversation:

```sh
singular-house call start_house '{"name": "Our house"}'
singular-house tools            # every tool and its arguments
```

No `singular-house` command either: run `curl -fsSL https://house.singular-labs.ai/install | sh` first (Windows:
`irm https://house.singular-labs.ai/install.ps1 | iex`).

## Make a house

1. `start_house(name)` gives a `draft_id` and `ask_first`: send that first message, asking for everything at once
   (plans, inspiration, photos, the address), and read all the person sends before asking anything else.
2. `set_location(draft_id, lat, lon, address?)` for a street address or a plot; skip it otherwise: the house is made
   without one and says so.
3. Read every plan yourself and `describe_plan` each one (a file only in the chat: its `filename` and `pages`); the
   server reads no plan and needs no copy. Photos go in with `add_file(draft_id, kind="photo", filename=...)`: with no
   `file` it gives an upload link; send the bytes with `curl -fsS -T <file> <url>`, never as base64 through the
   conversation. Record each question you ask with `note_question`. A plan that is not clear (no legible scale or
   numbers, a label you cannot read, a photo sideways, small or blurred): turn it upright and enlarge it, then ask the
   person for a clearer copy, the scale or the numbers first. A guess is the last resort, once they have nothing
   better, and you tell them what you guessed.
4. `finish_house(draft_id)`, tell the person in one line what you are making, and call `create_house(draft_id)` right
   away: nobody approves it. Hold back its `open_url`: the house is an empty plot until its model lands.
5. The new house has no 3D model yet, and nothing builds it for you: until it has one, the tools that show or change
   it answer "this house has no model yet". Read the plans, search the guide for `model-format`, `validate_model`
   the model you read, fix what it reports with `edit_model`, then `set_model(model_id)`: it lands as made. Then give
   the person a fresh `open_link`.

## Rules

- Sign-in: the first call prints a link when the person is not signed in. Give them the link, wait for them to say
  they signed in, then run the same command again. That is the only thing they ever have to click.
  The person opens the link in their own browser. Never open it yourself, never sign in for them, and never ask
  for a password or a sign-in code (their Singular Labs account, Google, or any other): you never need one.
- What the person asks for, you do: `start_step` with their words, then the writes; each lands as it is made, and
  `revert_step` takes the step back. Never ask them to approve a change they asked for. `approve_change` is only for
  a change an approve share made (the owner's explicit yes) or a custom finish (the person's explicit yes).
- A tool that fails in a way you cannot get past: `report_problem` with what you did and the error.
- `record_video` records the viewer walking the house: it starts a job, so it is not read-only. Poll it with
  `recording_status`, which only reads that job; once done, give the person its `watch_url` (the video plays in
  their browser, no sign-in).
- For detail on any step (reading plans into the model, undoing, a tool that failed), search the server's guide with
  its `house_development_guide_grep` tool before acting.
- No shell and no MCP client, only web requests: `POST https://house.singular-labs.ai/mcp/connect` with `{"client_name": "<you>"}`, give
  the person its `verification_uri_complete` link and `user_code`, then `POST https://house.singular-labs.ai/mcp/connect/token` with the
  `device_code` every `interval` seconds until it returns `access_token` for https://house.singular-labs.ai/mcp/house.
- More: https://house.singular-labs.ai/llms.txt
