Use Estanza from your AI

For AI agents

Endpoint

https://api.estanza.casa/mcp, remote MCP over Streamable HTTP. Stateless: no session id, the home id is the only handle.

Auth

OAuth 2.1 with PKCE. An unsigned call gets HTTP 401 with WWW-Authenticate: Bearer resource_metadata=.... Clients register with a Client ID Metadata Document or dynamic client registration. The person signs in on an Estanza page; you never handle a password.

Scopes

homes:read, homes:write, homes:publish. Publishing is its own consent.

Units

Centimetres. Ids come from read_home. edit_home applies a list of actions all or nothing, one version per call; dry_run: true returns the plan picture without saving.

Errors

A business error is a normal result with isError: true, a plain sentence to repeat to the person, and a code in structuredContent, for example home_limit.

Seeing it

render_plan returns a PNG of a floor. view_url returns a capture link: open it in a headless browser, wait for html[data-ready="true"], then screenshot.

Models

upload_model takes a GLB. Every viewer and wall tablet downloads it on each load, so aim under 500 KB, never over 25 MB: real-world scale in metres, Y up, a few thousand triangles, textures 1024 px or less.

Plans

upload_plan puts a floor plan picture under a floor. Shrink it first without losing the lines: WebP only, no camera metadata, longest side about 2000 px, under 500 KB, never over 3 MB. Then read it yourself, draw the walls with edit_home, and ask the person for one real length to set the scale.

Data

Homes only. get_limits returns homes and storage used and allowed; no tool returns an email, a name or sign-in details.

Tools

homes:readget_limitslist_homesread_homerender_planview_urllist_versionssearch_cataloglist_templates

homes:writecreate_homerename_homeduplicate_homedelete_homeedit_homeundorestore_versionrequest_furnitureupload_modelupload_plan

homes:publishpublishunpublish

Index

/llms.txt

What it is

MCP, the Model Context Protocol, is an open standard that lets an AI assistant use another service for you, the way an app on your phone uses your camera once you allow it.

The Estanza MCP server lets your assistant read your homes and change them with the same tools the Estanza editor uses. You sign in to Estanza, not to the assistant, and you can take the access back at any time.

How to connect

Every app uses the same address. Find yours below, then sign in to Estanza and allow access when it asks.

https://api.estanza.casa/mcp

Claude: open Customize, then Connectors. Choose Add custom connector, paste the address and sign in.
ChatGPT: turn on Developer mode under Settings, Security and login. Then open Plugins, press + and paste the address.
Le Chat: open Connectors. Choose Add Connector, then Custom MCP Connector, paste the address and sign in.
Cursor: Add to Cursor in one click, then sign in when Cursor asks.

Claude Code: run this, then /mcp to sign in.

claude mcp add --transport http estanza https://api.estanza.casa/mcp

Codex: run this, then codex mcp login estanza to sign in.

codex mcp add estanza --url https://api.estanza.casa/mcp

Any other app or agent: add a custom MCP connector or server with the address above. An agent that edits its own MCP config takes:
```
{"mcpServers":{"estanza":{"url":"https://api.estanza.casa/mcp"}}}
```

Chat apps cannot add a connector from a message, so paste the address in their settings as shown. Then turn Estanza on in a chat and ask.

What your AI can do

Say what you want, for example "make the second bedroom an office and put the desk under the window". Your assistant can:

Start a home, blank or from one of the Estanza templates.
Trace a floor plan picture you give it: it draws the walls and asks you for one real length to set the scale.
Change it: rooms, floors, walls, doors, windows, stairs, furniture, lights, cables, garden and notes. Each change is a new version, so you can undo it from the editor.
Look at it: a picture of the floor plan drawn by Estanza, and a link to the 3D view.
Publish it and hand you the share link and the Home Assistant card link, with the steps to put the card on your dashboard.
Add your own 3D model of a piece of furniture and place it.

Every change also shows up in the Estanza editor, so you can carry on by hand whenever you like.

Limits

Changes made from your AI never count against the asks in the editor, because your assistant does the thinking. The usual account limits still apply: how many homes, 100 MB of storage, saves per day and home size.

Privacy

Homes only. Your assistant sees your homes and nothing personal: no email, no name, no sign-in details.
Your assistant reaches only your own homes, and only after you sign in to Estanza and allow it.
It never sees your password or your Estanza session.
Publishing a home needs its own permission.
Disconnect any app in the Estanza app, under Settings, Connected apps. Signing out everywhere or deleting your account disconnects them all.
See the privacy policy for the rest.

Claude is a trademark of Anthropic. ChatGPT is a trademark of OpenAI. Le Chat is a trademark of Mistral AI. Cursor is a trademark of Anysphere. Their marks are shown only to say Estanza works with them; Estanza is not affiliated with or endorsed by any of them.