# Singular House

> Singular House (https://house.singular-labs.ai, by Singular Labs) turns an architect's plans into a 3D house the person can walk
> through, then lets them choose finishes, furniture and products on it and see what it costs. AI agents work it for
> the person through MCP. This file tells an AI agent how to start when a person says something like "I want to
> create a house with Singular House".

## If a person asks you to create or work on a house with Singular House

Pick the first case that fits you, and do it without asking the person to set anything up:

1. **You already have Singular House's tools** (`start_house`, `upload_link`, `create_house`, ... from
   `singular-house-new`; `list_houses`, `list_choices`, `add_product`, ... from `singular-house`): use them. See
   "Make a house" below.
2. **You can run shell commands** (Claude Code, Codex, Gemini CLI, Cursor, Copilot, Windsurf, Cline, Goose, Aider,
   OpenHands, Devin, Manus, any coding agent):

   ```sh
   curl -fsSL https://house.singular-labs.ai/install | sh
   ```

   On Windows PowerShell: `irm https://house.singular-labs.ai/install.ps1 | iex`. It installs the `singular-house` command, adds both MCP
   servers to every AI client on the machine for next time, and prints one sign-in link: give that link to the
   person. Then call the tools right away, in this same conversation:

   ```sh
   singular-house login                      # waits for the person; run again if it says it is still waiting
   singular-house tools new                  # the tools and their arguments
   singular-house call new start_house '{"name": "Our house"}'
   ```

   Python 3.8+ is the only requirement. `singular-house setup --client claude` limits it to one client
   (claude, codex, gemini, cursor, vscode, windsurf).
3. **You can add MCP servers but not run commands**: add the remote MCP server https://house.singular-labs.ai/mcp/new (streamable
   HTTP, OAuth with dynamic client registration; a client that wants a client ID uses `dbd6880963d1c665585b`, no secret).
   Add https://house.singular-labs.ai/mcp/house as well to work on the house afterwards.
4. **You are a chat app the person cannot add tools to from the chat** (ChatGPT, claude.ai, Claude Desktop or
   mobile, Gemini, Perplexity, Le Chat): if Singular House is in your app or connector directory, turn it on.
   Otherwise tell the person, in one short step: "Add a connector with this URL: https://house.singular-labs.ai/mcp/new" and where your
   app keeps that (ChatGPT: Settings > Apps & Connectors > Create; Claude: Settings > Connectors > Add custom
   connector; Perplexity and Le Chat: Settings > Connectors). They sign in once with a Singular Labs account,
   which they can make on that page. Or they make it themselves in the browser: https://house.singular-labs.ai/new

## Make a house

1. `start_house(name)` gives a `draft_id`. Ask only for what you do not have: a name, the plans (the architect's
   DWFX, DWG/DXF, PDF or images), where it is (an address or a point), photos if any.
2. `set_location(draft_id, lat, lon, address?)`, or skip it: the house is made without one and says so.
3. Each plan: `upload_link(draft_id, kind="plan", filename=...)` and send the bytes with `curl -fsS -T <file> <url>`
   (never as base64 through the model). Photos the same with `kind="photo"`. Read the plans yourself and
   `describe_plan` each; `ask_user` only what you cannot tell.
4. `finish_house(draft_id)`: show the person the summary. `create_house(draft_id)` only after they say yes,
   then give them the link to their house (its `open_url`, else https://house.singular-labs.ai/).

## Rules

- The person signs in once with a link (OAuth). Give them the link and continue after they say they signed in.
- Every change to a house is a pending change with preview pictures. Show them and call `approve_change` only after
  the person explicitly says yes; `reject_change` on a no.
- A tool that fails in a way you cannot get past: `report_problem`.

## Links

- [Make a house (MCP)](https://house.singular-labs.ai/mcp/new): streamable HTTP, OAuth
- [Work on a house (MCP)](https://house.singular-labs.ai/mcp/house): streamable HTTP, OAuth
- [Installer](https://house.singular-labs.ai/install): POSIX sh; [Windows](https://house.singular-labs.ai/install.ps1)
- [Agent skill](https://house.singular-labs.ai/skill.md): SKILL.md for agents that load skills
- [Make a house in the browser](https://house.singular-labs.ai/new)
- [Privacy](https://house.singular-labs.ai/privacy), [Terms](https://house.singular-labs.ai/terms), [Support](https://house.singular-labs.ai/support)