Gebruik Estanza vanuit je 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

Wat het is

MCP, het Model Context Protocol, is een open standaard waarmee een AI-assistent een andere dienst voor je kan gebruiken, zoals een app op je telefoon je camera gebruikt zodra je dat toestaat.

Met de MCP-server van Estanza kan je assistent je huizen lezen en aanpassen met dezelfde tools die de Estanza-editor gebruikt. Je logt in bij Estanza, niet bij de assistent, en je kunt de toegang altijd weer intrekken.

Zo koppel je het

Elke app gebruikt hetzelfde adres. Zoek de jouwe hieronder, log daarna in bij Estanza en geef toegang als daarom gevraagd wordt.

https://api.estanza.casa/mcp

Claude: open Customize en dan Connectors. Kies Add custom connector, plak het adres en log in.
ChatGPT: zet Developer mode aan onder Settings, Security and login. Open daarna Plugins, druk op + en plak het adres.
Le Chat: open Connectors. Kies Add Connector, dan Custom MCP Connector, plak het adres en log in.
Cursor: Toevoegen aan Cursor met één klik, en log in als Cursor erom vraagt.

Claude Code: voer dit uit en daarna /mcp om in te loggen.

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

Codex: voer dit uit en daarna codex mcp login estanza om in te loggen.
```
codex mcp add estanza --url https://api.estanza.casa/mcp
```
Elke andere app of agent: voeg met het adres hierboven een eigen MCP-connector of -server toe. Een agent die zijn eigen MCP-configuratie bewerkt, gebruikt:
```
{"mcpServers":{"estanza":{"url":"https://api.estanza.casa/mcp"}}}
```

Chat-apps kunnen geen connector toevoegen vanuit een bericht, dus plak het adres in hun instellingen zoals hierboven. Zet Estanza daarna aan in een chat en vraag maar.

Wat je AI kan

Zeg wat je wilt, bijvoorbeeld "maak van de tweede slaapkamer een kantoor en zet het bureau onder het raam". Je assistent kan:

Een huis beginnen, leeg of vanuit een van de Estanza-sjablonen.
Een plattegrondafbeelding overtrekken die je geeft: hij tekent de muren en vraagt je één echte lengte om de schaal te bepalen.
Het aanpassen: kamers, verdiepingen, muren, deuren, ramen, trappen, meubels, lampen, kabels, tuin en notities. Elke wijziging is een nieuwe versie, dus je kunt hem ongedaan maken in de editor.
Het laten zien: een plattegrond getekend door Estanza en een link naar de 3D-weergave.
Het publiceren en je de deellink en de link voor de Home Assistant-kaart geven, met de stappen om de kaart op je dashboard te zetten.
Je eigen 3D-model van een meubelstuk toevoegen en plaatsen.

Elke wijziging verschijnt ook in de Estanza-editor, dus je kunt altijd met de hand verder.

Limieten

Wijzigingen vanuit je AI tellen nooit mee voor de vragen in de editor, want je assistent doet het denkwerk. De gewone accountlimieten blijven gelden: aantal huizen, 100 MB opslag, aantal keer opslaan per dag en grootte van het huis.

Privacy

Alleen huizen. Je assistent ziet je huizen en niets persoonlijks: geen e-mail, geen naam, geen inloggegevens.
Je assistent komt alleen bij je eigen huizen, en pas nadat je bij Estanza hebt ingelogd en toestemming hebt gegeven.
Hij ziet nooit je wachtwoord of je Estanza-sessie.
Een huis publiceren vraagt om aparte toestemming.
Ontkoppel elke app in de Estanza-app, onder Instellingen, Gekoppelde apps. Overal uitloggen of je account verwijderen ontkoppelt ze allemaal.
Lees de privacyverklaring voor de rest.

Claude is een merk van Anthropic. ChatGPT is een merk van OpenAI. Le Chat is een merk van Mistral AI. Cursor is een merk van Anysphere. Hun merken staan hier alleen om te laten zien dat Estanza ermee werkt; Estanza is niet verbonden aan of goedgekeurd door een van hen.