Plataforma API y MCP de CASAFARI: datos inmobiliarios para agentes de IA
Acceda a la Plataforma API y MCP de CASAFARI para conectar Claude, ChatGPT y agentes autónomos al mayor grafo inmobiliario de España y Europa.
La plataforma autoservicio en platform.casafari.com permite a los agentes de inteligencia artificial y a los equipos profesionales consultar el grafo inmobiliario de CASAFARI en España y otros 15 países. Una sola cuenta, un saldo único de tokens de consumo, inicio de sesión mediante OAuth 2.1 en el navegador y un plan gratuito sin tarjeta de crédito cubren todos los servidores MCP y endpoints REST.
Qué es la Plataforma API y MCP de CASAFARI
A las nueve de la mañana, un responsable de análisis de una red inmobiliaria en Madrid abre Claude, añade el conector de Comparables, inicia sesión en el navegador y obtiene los inmuebles comparables de un piso en Chamberí antes del primer café. Sin abrir un ticket a tecnología y sin pegar claves secretas en la ventana de chat.
Esa es la arquitectura de la Plataforma API y MCP de CASAFARI en platform.casafari.com. CASAFARI estructura el mayor grafo de datos inmobiliarios de Europa: un registro unificado y desduplicado de inmuebles residenciales y comerciales, en venta y en alquiler, en 16 países (Alemania, Andorra, Austria, Bélgica, Emiratos Árabes Unidos, España, Estados Unidos, Francia, Grecia, Italia, Luxemburgo, Mónaco, Polonia, Portugal, San Marino y Suiza; EE. UU.: en plena entrada, estados seleccionados, solo inmuebles comerciales, con Claro AI). Cada propiedad constituye una única ficha que conserva todo su historial de cambios de precio, estado y retirada de portales, según los datos del grafo inmobiliario de CASAFARI (octubre de 2026).
En España, la plataforma está diseñada para equipos de desarrollo proptech, directores de innovación en agencias y franquicias, analistas de fondos y servicers, sociedades de tasación y profesionales que utilizan asistentes como Claude o ChatGPT en su día a día y requieren respuestas respaldadas por datos reales de mercado.
Por qué CASAFARI es una plataforma nativa para agentes de IA
CASAFARI es una plataforma nativa para agentes de IA (AI-agent native). Esta afirmación se sostiene sobre cinco características técnicas concretas:
- Una cuenta compartida: personas y agentes operan sobre la misma cuenta, con los mismos permisos y la misma bolsa de tokens.
- Identificación transparente: el inicio de sesión se realiza mediante OAuth 2.1 en el navegador, por lo que el agente nunca manipula ni almacena contraseñas.
- Herramientas de lectura segura: 19 de las 21 herramientas MCP documentadas son exclusivamente de lectura (
readOnlyHint). - Documentación estructurada para modelos: se publican puntos de entrada específicos como
llms.txt, especificaciones OpenAPI y archivos Markdown en developers.casafari.com (octubre de 2026). - Coste predecible por llamada: cada herramienta indica en su descripción el número exacto de tokens de consumo que descuenta del saldo.
Para profundizar en la integración, consulte la página de producto de Casafari MCP y la guía de conexión en developers.casafari.com (en inglés).
Los servidores MCP, uno por producto
Cada producto de CASAFARI funciona como un servidor MCP independiente que utiliza el transporte Streamable HTTP y autenticación OAuth 2.1. A continuación se detallan las herramientas disponibles.
Location Lookup
El servidor Location Lookup (https://platform.casafari.com/mcp/locations) resuelve nombres de lugares como Chamberí, Eixample o Marbella a identificadores únicos de ubicación (location IDs). Esta herramienta es gratuita, incluso tras agotar los primeros 30 días del plan Free, y constituye el primer paso que ejecutan la mayoría de flujos de trabajo.
Area Insights
Este servidor pone a disposición 7 herramientas analíticas que incluyen series temporales de precios, distribuciones por importe, número de dormitorios y días en mercado, tasa de crecimiento anual compuesto (CAGR), volatilidad y mapas de calor por distrito. Por ejemplo, un agente puede comparar la evolución del precio por metro cuadrado en el distrito de Salamanca frente a Retiro durante los últimos tres años. Más información en la página sobre Insights de Zona en la plataforma CASAFARI.
Comparables
El servidor Comparables analiza el mercado para seleccionar inmuebles semejantes a una propiedad dada y calcular una estimación de precio representativa. Resulta idóneo para analistas bancarios, tasadores y agentes inmobiliarios. Puede ampliar detalles en la sección de valoraciones y estudio de mercado.
AgentGraph AI
AgentGraph AI reúne 13 herramientas especializadas en evaluar redes y agentes inmobiliarios en Alemania, mapas territoriales y fichas operativas. Este servidor cubre exclusivamente el mercado alemán y requiere validación de empresa. Es de utilidad para redes españolas con expansión en Alemania.
Claro AI
Claro AI analiza locales comerciales en alquiler o venta en España y parcelas comerciales en Alemania a partir de instrucciones redactadas en lenguaje natural. Incorpora datos de Location Intelligence sobre tráfico peatonal, población residente y nivel socioeconómico.
Entre los ejemplos registrados el 16 de octubre de 2026 en developers.casafari.com, la búsqueda de un local para un café de especialidad en Valencia (40-120 m², menos de 3.500 €/mes) identificó 546 coincidencias que Claude redujo a una lista corta de los seis mejores locales. En otro caso, la localización de un club de gimnasia en las áreas metropolitanas de Madrid y Barcelona evaluó 483 opciones hasta seleccionar siete candidatos con dosier completo.
Para explorar estas capacidades, consulte la documentación de Claro AI (en inglés) y la solución Casafari for Business Expansion.
Productos solo REST en la misma cuenta
Determinados servicios operan mediante API REST tradicional utilizando la misma cuenta y el mismo saldo de tokens. Se accede a ellos mediante una clave de API (cf_sk_...) enviada en la cabecera Authorization: Bearer:
- Property Sourcing: permite realizar búsquedas directas en el grafo inmobiliario, consultar el historial completo de un inmueble o resolver un enlace de portales como idealista, Fotocasa o habitaclia a su registro único.
- High Potential Seller Leads: identifica viviendas que han aplicado reducciones sucesivas en su precio de salida alrededor de un punto geográfico. La plataforma entrega únicamente datos del inmueble; no proporciona nombres, teléfonos ni correos electrónicos, dejando la gestión de contacto en manos del profesional.
Consulte más información sobre las API de datos inmobiliarios de CASAFARI.
Cómo darse de alta y cómo funcionan los tokens
El registro se realiza en crear una cuenta en la consola de platform.casafari.com sin solicitar tarjeta de crédito. La plataforma asigna 1.000 tokens de consumo para los primeros 30 días en el plan Free. Finalizado este periodo, las búsquedas de ubicación en Location Lookup continúan siendo gratuitas.
Existen planes por suscripción mensual (plan Agent), acuerdos corporativos personalizados (plan Custom) y la posibilidad de adquirir tokens prepagados para consumos puntuales. Una sola cuenta mantiene un balance unificado de tokens que se descuentan según la tarifa fija indicada en la especificación de cada herramienta. Las recargas y pagos los realiza siempre una persona desde la consola, nunca el agente de forma autónoma. Puede consultar los planes y precios actuales (en inglés).
Cómo conectar Claude, ChatGPT, Claude Code, Gemini CLI, Cursor o VS Code
La vinculación con clientes MCP se realiza en pocos pasos:
- Claude (claude.ai, aplicación de escritorio y móvil): abra Personalizar (Customize) → Conectores (Connectors) → Añadir conector personalizado (Add custom connector), pegue la URL del servidor MCP deseado e inicie sesión en el navegador.
- ChatGPT: active el modo desarrollador, cree un conector introduciendo la URL del servidor MCP y configure la autenticación OAuth.
- Claude Code y Gemini CLI: ejecute el comando de incorporación con el transporte HTTP:
claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparableso biengemini mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparablesseguido de/mcp auth. - Entornos de desarrollo: Cursor, VS Code, Zed, Cline, JetBrains Junie y otros clientes compatibles integran los servidores de la plataforma. CASAFARI está disponible en el directorio de Cursor y en el registro oficial de MCP como
com.casafari.
También se encuentra disponible el repositorio casafari-mcp en GitHub.
Seguridad: qué puede hacer un agente y qué no
La plataforma aplica el protocolo OAuth 2.1 con PKCE (Proof Key for Code Exchange). El cliente de IA no recibe ni almacena las credenciales del usuario. Los tokens de acceso OAuth (diferentes de los tokens de consumo de la cuenta) están restringidos a un único servidor según el estándar RFC 8707, tienen una validez de 15 minutos y emplean refresh tokens rotativos.
En ejecuciones desatendidas se utiliza una clave de API o un cliente confidencial configurado previamente por una persona. Cada llamada comprueba los permisos activos y el saldo disponible. Además, 19 de las 21 herramientas MCP documentadas son de solo lectura; las dos herramientas con capacidad de escritura solicitan confirmación previa al usuario.
La salida emitida por las herramientas se procesa estrictamente como datos de consulta, evitando interpretaciones como instrucciones del sistema. Puede verificar la arquitectura en la documentación de seguridad (en inglés).
Cuánto cuesta
El acceso inicial no requiere tarjeta de crédito e incluye 1.000 tokens de consumo para probar la plataforma durante 30 días. Para uso continuo, existen planes mensuales por suscripción, contratación personalizada para empresas y paquetes de tokens prepagados. La relación actualizada de costes por llamada está disponible en la guía de planes y precios actuales (en inglés).
Dónde seguir
Para comenzar a trabajar con la plataforma, cree su acceso en crear una cuenta en la consola de platform.casafari.com. Si desea consultar guías de implementación, explore los casos de uso para desarrolladores (en inglés) y los puntos de entrada legibles por máquina para agentes (en inglés).
También puede revisar otros recursos prácticos como los atajos de ChatGPT para agentes inmobiliarios, la guía explicativa sobre qué es una API inmobiliaria y el caso de IA agéntica de Porta da Frente Christie's. Próximamente se publicará la sección dedicada a flujos agénticos avanzados.
Preguntas frecuentes
¿Qué es un servidor MCP y para qué sirve en el sector inmobiliario?
Model Context Protocol (MCP) es un estándar abierto que permite a asistentes como Claude o ChatGPT conectarse de forma segura a fuentes de datos externas. Un servidor MCP de CASAFARI expone herramientas de consulta especializadas (como Comparables o Area Insights) para que el agente obtenga información verificada directamente del grafo inmobiliario en lugar de depender únicamente de la memoria del modelo.
¿Cómo conecto Claude o ChatGPT a datos inmobiliarios de España?
En Claude, acceda a Personalizar (Customize) → Conectores (Connectors) → Añadir conector personalizado (Add custom connector), pegue la dirección URL del servidor MCP (por ejemplo, https://platform.casafari.com/mcp/comparables) e inicie sesión en el navegador. En ChatGPT, configure un nuevo conector en el modo desarrollador introduciendo la misma URL y el flujo OAuth. No se requiere copiar claves manuales en la conversación.
¿Cuánto cuesta usar la API de CASAFARI?
El plan Free permite registrarse sin tarjeta e incluye 1.000 tokens de consumo para utilizar durante 30 días, manteniendo las búsquedas en Location Lookup gratuitas posteriormente. Existen planes de suscripción mensual (Agent), planes a medida (Custom) y tokens prepagados. Cada llamada a una herramienta descuenta una cantidad fija de tokens indicada en su especificación.
¿Puedo usar un agente de IA para valorar un piso con datos reales?
Sí, utilizando el servidor MCP de Comparables o la API REST correspondiente. El agente envía las características del inmueble y recibe la selección de comparables activos y cerrados junto con el cálculo del precio estimado generado a partir de las transacciones e historial del grafo inmobiliario.
¿Es seguro dar acceso a un agente de IA a una API de datos?
La plataforma emplea el protocolo OAuth 2.1 con PKCE, garantizando que el agente nunca conozca las credenciales de la cuenta. Los tokens de acceso expirante a los 15 minutos y quedan restringidos a un único servidor; además, 19 de las 21 herramientas MCP documentadas son de solo lectura y las recargas de saldo requieren siempre la acción directa de una persona.
¿Qué datos inmobiliarios de España puede consultar un agente de IA?
El agente puede acceder al historial de precios y retiradas de anuncios (Property Sourcing), valoraciones y selección de comparables (Comparables), estadísticas del mercado e indicadores por zona (Area Insights), búsqueda de locales comerciales con datos sociodemográficos y de afluencia (Claro AI) e inmuebles con rebajas continuadas de precio (High Potential Seller Leads). El servidor AgentGraph AI cubre exclusivamente el mercado alemán.