NidoRaíz

Desarrolladores y agentes de IA

NidoRaíz está hecho para consultarse por máquina, no solo por navegador. Hay tres puertas, de menor a mayor privilegio: el servidor MCP público (solo lectura, sin credenciales), la conexión OAuth al CRM (para operar una cuenta con permisos por alcance) y la API REST.

Servidor MCP público — sin registro

Pega https://mcp.nidoraiz.co en cualquier cliente que hable Model Context Protocol y ya: no pide credenciales. Expone el inventario en vivo con la moneda y la unidad de área explícitas en cada campo.

Herramientas disponibles: buscar_inmuebles, ver_inmueble, calcular_financiacion, evaluar_inversion, listar_proyectos y agendar_visita (esta última solo con consentimiento explícito de la persona). Antes de responder conviene leer los recursos nido://catalogo/municipios (dónde hay inventario de verdad) y nido://catalogo/tipos-y-negocios (los valores exactos que aceptan los filtros).

Operar el CRM — OAuth 2.1 con alcances

Una inmobiliaria puede conectar su asistente de IA a su propia cuenta en https://mcp.nidoraiz.co/crm: OAuth 2.1 con PKCE, registro dinámico de clientes, pantalla de consentimiento y permisos por alcance (una clave con solo lectura de inventario no ve las herramientas de escritura ni de mensajería). Las escrituras sensibles exigen confirmación explícita en la llamada.

Las claves de API y su alcance se administran desde la cuenta, en la sección de documentación de API de la aplicación.

API REST

La documentación Swagger de la API está publicada y navegable. La superficie pública (sin autenticación) sirve el buscador de inmuebles que usa este mismo sitio:

curl -s "https://nidoraiz.com/api/public-api/properties/search?limit=3" \
  -H "Accept: application/json"

Para agentes que leen el sitio

Las páginas públicas sirven JSON-LD (RealEstateListing en cada ficha, Organization en la portada). Las rutas inexistentes devuelven 404 de verdad, y las páginas principales tienen variante markdown por negociación de contenido (Accept: text/markdown).