Usa Estanza desde tu IA

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

Qué es

MCP, el Model Context Protocol, es un estándar abierto que permite a un asistente de IA usar otro servicio por ti, igual que una app del móvil usa la cámara cuando se lo permites.

El servidor MCP de Estanza permite a tu asistente leer tus casas y cambiarlas con las mismas herramientas que usa el editor de Estanza. Inicias sesión en Estanza, no en el asistente, y puedes retirarle el acceso cuando quieras.

Cómo conectarlo

Todas las apps usan la misma dirección. Busca la tuya abajo, inicia sesión en Estanza y permite el acceso cuando te lo pida.

https://api.estanza.casa/mcp

Claude: abre Customize y luego Connectors. Elige Add custom connector, pega la dirección e inicia sesión.
ChatGPT: activa Developer mode en Settings, Security and login. Después abre Plugins, pulsa + y pega la dirección.
Le Chat: abre Connectors. Elige Add Connector, luego Custom MCP Connector, pega la dirección e inicia sesión.
Cursor: Añadir a Cursor con un clic, e inicia sesión cuando Cursor te lo pida.

Claude Code: ejecuta esto y luego /mcp para iniciar sesión.

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

Codex: ejecuta esto y luego codex mcp login estanza para iniciar sesión.
```
codex mcp add estanza --url https://api.estanza.casa/mcp
```
Cualquier otra app o agente: añade un conector o servidor MCP personalizado con la dirección de arriba. Un agente que edita su propia configuración MCP necesita esto:
```
{"mcpServers":{"estanza":{"url":"https://api.estanza.casa/mcp"}}}
```

Las apps de chat no pueden añadir un conector desde un mensaje, así que pega la dirección en sus ajustes como se indica. Luego activa Estanza en un chat y pide lo que quieras.

Qué puede hacer tu IA

Di lo que quieres, por ejemplo "convierte el segundo dormitorio en un despacho y pon el escritorio bajo la ventana". Tu asistente puede:

Empezar una casa, en blanco o a partir de una de las plantillas de Estanza.
Calcar la imagen de un plano que le des: dibuja las paredes y te pide una medida real para fijar la escala.
Cambiarla: habitaciones, plantas, paredes, puertas, ventanas, escaleras, muebles, luces, cables, jardín y notas. Cada cambio es una versión nueva, así que puedes deshacerlo desde el editor.
Verla: una imagen del plano dibujada por Estanza y un enlace a la vista en 3D.
Publicarla y darte el enlace para compartir y el de la tarjeta de Home Assistant, con los pasos para ponerla en tu panel.
Añadir tu propio modelo 3D de un mueble y colocarlo.

Cada cambio aparece también en el editor de Estanza, así que puedes seguir a mano cuando quieras.

Límites

Los cambios hechos desde tu IA nunca cuentan para las preguntas del editor, porque es tu asistente quien piensa. Se siguen aplicando los límites habituales de la cuenta: número de casas, 100 MB de almacenamiento, guardados al día y tamaño de la casa.

Privacidad

Solo casas. Tu asistente ve tus casas y nada personal: ni correo, ni nombre, ni datos de inicio de sesión.
Tu asistente solo llega a tus propias casas, y solo después de que inicies sesión en Estanza y se lo permitas.
Nunca ve tu contraseña ni tu sesión de Estanza.
Publicar una casa necesita su propio permiso.
Desconecta cualquier app desde la app de Estanza, en Ajustes, Apps conectadas. Cerrar sesión en todas partes o eliminar tu cuenta las desconecta todas.
Consulta la política de privacidad para todo lo demás.

Claude es una marca de Anthropic. ChatGPT es una marca de OpenAI. Le Chat es una marca de Mistral AI. Cursor es una marca de Anysphere. Sus marcas se muestran solo para indicar que Estanza funciona con ellas; Estanza no está afiliada a ninguna de ellas ni cuenta con su respaldo.