Casafari MCP

Inteligencia de datos inmobiliarios, construida para agentes de IA. Casafari es la plataforma de inteligencia de datos inmobiliarios nativa para agentes de IA. Grafo de propiedades deduplicado y limpio. El índice de propiedades más completo de Europa.

Ver en casafari.com

Servidor MCP alojado

npx add-mcp 'https://mcp.casafari.com/'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Plataforma API y MCP de Casafari

Casafari es la plataforma de inteligencia de datos inmobiliarios nativa para agentes de IA. El índice de propiedades más completo de Europa: un grafo de propiedades residenciales y comerciales, en venta y en alquiler, deduplicado y limpiado, en 16 países.

Cada propiedad en el grafo es un único registro, fusionado de cada fuente que la anuncia y limpiado, con su historial completo: cada cambio de precio, cada cambio de estado, cuándo salió al mercado y cuándo fue retirada. Tanto propiedades residenciales como comerciales, en venta y en alquiler. Cómo se construye el grafo de propiedades.

Los servidores MCP de Casafari conectan asistentes y agentes de IA a esta plataforma como herramientas del Model Context Protocol: búsqueda de ubicaciones, comparables y valoraciones, perspectivas de área, y análisis de agencias y agentes. Forman parte de la Plataforma API y MCP de Casafari, donde cada producto es su propio servidor MCP con su propia URL e inicio de sesión OAuth.

Los mismos datos también están disponibles a través de una API REST (46 operaciones en https://api.casafari.com). La documentación está organizada por producto, y cada producto enumera sus herramientas MCP y sus operaciones REST; MCP y REST comparados muestra dónde se superponen y dónde no.

¿Ya eres cliente de la API de Casafari? Tu token sigue funcionando, y la referencia de la API existente ahora está en este sitio. Inicia sesión en tu cuenta de API para ver tu token.

Endpoints

Un servidor MCP por producto en la plataforma (Streamable HTTP, inicio de sesión OAuth 2.1 en el navegador, sin clave que copiar):

Location Lookup: https://platform.casafari.com/mcp/locations
Area Insights: https://platform.casafari.com/mcp/area-insights
Comparables: https://platform.casafari.com/mcp/comparables
AgentGraph AI: https://platform.casafari.com/mcp/agentgraph (solo negocios verificados)
Claro AI: https://platform.casafari.com/mcp/claro

En Claude Code, por ejemplo: claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables. En Claude o ChatGPT, añade un conector personalizado con la URL del producto. Pasos para Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI, Zed y otros clientes: Conectar y Conectar a la Plataforma Casafari.

¿Ya eres cliente de Casafari? Usa los mismos servidores: regístrate en https://platform.casafari.com/console/, y si tienes un contrato, Casafari configura tu cuenta en el plan Custom. mcp.casafari.com se ha retirado; usa https://platform.casafari.com/mcp/<product>.

Cada servidor publica su propia tarjeta en <server URL>/.well-known/mcp/server-card.json, por ejemplo https://platform.casafari.com/mcp/comparables/.well-known/mcp/server-card.json. Inicio de sesión: Autenticación.

Claro AI también es un producto de la plataforma; con una clave de API de la plataforma en lugar de OAuth, consulta Conectar Claro.

Productos

Producto	Herramientas MCP	Operaciones REST	Qué responde
Property Sourcing	—	10	Encuentra propiedades en el grafo de propiedades, donde cada propiedad es un único registro sin importar cuántas agencias y portales la anuncien: busca por filtros estructurados o en lenguaje natural, navega por los resultados, lee una propiedad con todos los lugares donde se anuncia y su historial de precios, y resuelve un enlace de portal o agencia o una referencia a la propiedad a la que pertenece. Solo REST.
High Potential Seller Leads	—	2	Viviendas con probabilidad de venderse: propiedades alrededor de un punto cuyo precio de venta se recortó repetidamente, por cuántos recortes y cuánto en total, durante todo su tiempo en el mercado o desde una fecha. Cada lead enlaza a su propiedad y su historial de precios. Solo REST; España, Francia, Italia, Alemania, Grecia y Andorra.
Comparables & Valuation	1	4	Propiedades comparables y precios estimados para una vivienda: propiedades en el mercado, ventas y alquileres pasados, y registros oficiales, emparejados alrededor de un punto, una dirección o una referencia catastral.
Area Insights	7	6	Perspectivas para un área: precio, oferta y actividad a lo largo del tiempo, distribuciones por precio, dormitorios y tiempo en el mercado, y análisis de mercado. También por MCP, medidas de crecimiento y volatilidad y mapas de calor por distrito.
New Market Leads	—	12	Feeds de alertas que siguen el grafo de propiedades para un conjunto de filtros: nuevas propiedades, subidas y bajadas de precio, reservas, retiradas y ventas. Crea un feed, lee sus alertas, o haz que se entreguen a tu webhook.
References	—	10	Los datos de referencia a partir de los cuales se construyen las solicitudes: tipos de propiedad, características y condiciones, agencias, agentes y las fuentes de las que se construye el grafo, ubicaciones con autocompletado, y límites de códigos postales.
AgentGraph AI	13	—	Encuentra las agencias y agentes inmobiliarios con los que vale la pena asociarse: análisis de área contra perfiles de socios, perfiles completos, mapas de territorio, briefs de socios y listas de seguimiento.

Claro AI

Claro AI es el agente de búsqueda de expansión empresarial de Casafari para locales comerciales en toda España. Es un producto de la plataforma: su propio servidor MCP y API REST en la plataforma, con una clave de plataforma o el OAuth de la plataforma. Conectar Claro.

Cómo se nombran las herramientas

Cada servidor nombra sus herramientas <server>_<tool>: el prefijo es el último segmento de la URL del servidor, el resto es el nombre propio de la herramienta, por ejemplo comparables_get-comparables, area-insights_get_heatmap o agentgraph_screen_agencies. Las herramientas de Location Lookup son locations_search y locations_get, y cada servidor también tiene account_status. Llama siempre a una herramienta por su nombre completo, tal como lo lista el servidor.

Una API para agentes de IA

Casafari es una API para agentes de IA en dos formas, sobre el mismo grafo de propiedades:

Los servidores MCP (uno por producto bajo https://platform.casafari.com/mcp/), para agentes que descubren las herramientas y deciden cuáles llamar: en Claude, ChatGPT y otros clientes MCP, o desde tu propio código a través de la API de OpenAI o la API de Claude.
La API REST (referencia), para agentes y aplicaciones cuyo código hace solicitudes fijas.

Estos documentos también están escritos para agentes: cada página es Markdown, y /llms.txt los indexa todos.

Unidades, pago y verificación

Cada llamada cuesta un número fijo de unidades en tu cuenta de la plataforma, igual por MCP y REST. account_status, en cada servidor, muestra tu plan y saldo. Cuando las unidades se agotan, una herramienta responde con un error de pago que lleva un enlace que una persona abre para pagar; las herramientas de AgentGraph AI responden verification_required hasta que el negocio esté verificado. Límites por plan: Límites.

Empieza con una ubicación

La mayoría de las herramientas de datos toman una ubicación como ids, un círculo o un polígono en lugar de un nombre: resuelve un nombre de lugar a ids primero con locations_search de Location Lookup (https://platform.casafari.com/mcp/locations, gratis). AgentGraph AI tiene su propio agentgraph_find_location para Alemania.

Lee estos documentos como Markdown

Cada página tiene una versión Markdown: añade .md a su URL, o envía Accept: text/markdown. /llms.txt lista cada página y herramienta; /llms-full.txt es toda la referencia en un solo archivo. Más en Para agentes de IA.

Preguntas y respuestas

¿Cuál es la diferencia entre Casafari MCP y la API REST de Casafari, y cuál debería usar?

Usa MCP cuando un asistente o agente de IA llama a los datos de Casafari como herramientas; usa REST cuando tu propio código lo llama por HTTP. Los productos difieren entre ambos.

Si eres cliente de Casafari: la API REST de Casafari (https://api.casafari.com) se mantiene como está, con 39 operaciones; POST /login con correo electrónico y contraseña devuelve un token de acceso y uno de refresco. Property Sourcing, New Market Leads (alertas) y References son solo REST allí. Para MCP, usa los servidores de la plataforma de autoservicio como todos los demás: regístrate, y si tienes un contrato, Casafari configura tu cuenta en Custom. Consulta MCP y REST comparados y API REST.

Si eres nuevo en Casafari: en la plataforma de autoservicio, MCP sirve a asistentes, que inician sesión con OAuth 2.1 y no necesitan clave (Autenticación), para Location Lookup, Area Insights, Comparables & Valuation, AgentGraph AI y Claro AI. REST sirve a tu código, con una clave de API o un cliente OAuth, para Account, Location Lookup, Area Insights, Property Sourcing, High Potential Seller Leads, Alerts, Comparables & Valuation y Claro AI. Cada operación cuesta el mismo número de unidades por REST y MCP.

Consulta qué dirección usar y solo MCP y solo REST.

Enlace permanente: /docs/faq/mcp-vs-rest-api

¿Cómo funciona la autenticación en Casafari MCP? ¿Usa ámbitos OAuth?

Casafari MCP inicia sesión con OAuth 2.1 en los servidores MCP de la plataforma de autoservicio, sin clave de API; las API REST inician sesión con credenciales separadas.

Si eres cliente de Casafari: la API REST de Casafari toma un JWT de correo electrónico y contraseña, o un token para un cliente de API (autenticación REST), como antes. Para MCP, inicias sesión en los servidores de la plataforma de autoservicio como todos los demás, con una cuenta de plataforma.

Si eres nuevo en Casafari: los asistentes inician sesión en los servidores MCP de la plataforma de autoservicio con OAuth 2.1 y registro dinámico de clientes; no se necesita clave. Los ámbitos OAuth que usa ese inicio de sesión no se publican. La API REST de la plataforma toma una clave de API (cf_sk_…) en el encabezado X-API-Key o como Authorization: Bearer <api_key>, o un cliente OAuth que usa credenciales de cliente con el parámetro resource, cuyos tokens duran 15 minutos (¿clave o cliente OAuth?).

Consulta Autenticación y API REST.

Enlace permanente: /docs/faq/how-authentication-works

¿Quién puede usar Casafari MCP y la API de Casafari?

Cualquiera puede registrarse en platform.casafari.com sin hablar con ventas, y ahí es donde cada asistente se conecta por MCP; los clientes existentes de Casafari también mantienen su contrato de API REST de Casafari.

Si eres cliente de Casafari: tu acceso a la API REST de Casafari sigue vinculado a tu cuenta y contrato de Casafari, y un token lleva exactamente los derechos de esa cuenta; una integración desatendida usa un cliente de API que crea el propietario de la cuenta (autenticación REST). Para MCP, regístrate en la plataforma de autoservicio como todos los demás; si tienes un contrato, Casafari configura tu cuenta en Custom (Conecta tu asistente).

Si eres nuevo en Casafari: cualquiera puede crear una cuenta en https://platform.casafari.com,, empezar en el plan Free, una prueba que no requiere tarjeta, y pagar por uso. No se necesita verificación de negocio, excepto para AgentGraph AI, que contiene datos de contacto personales de agentes inmobiliarios (verificación). Una cuenta Free tiene 1 miembro y una cuenta Agent 3 (planes). Pasos: cómo registrarse.

¿No estás seguro de cuál es tu caso? Consulta qué dirección usar.

Enlace permanente: /docs/faq/who-can-use

¿Cuáles son los límites de tasa, cuotas y límites de uso de Casafari?

Casafari no publica cifras de límites de tasa o cuotas para los contratos existentes de API REST; la plataforma de autoservicio mide el uso en unidades, con límites establecidos por plan: Free, Agent y Custom, publicados en Límites y ventanas de uso.

Si eres cliente de Casafari: para cifras de cuota y límites de tasa en la API REST de Casafari, contacta con Casafari: https://www.casafari.com/ (cuota versus unidades). Por MCP usas la plataforma de autoservicio, donde los límites a continuación se aplican a tu cuenta; si tienes un contrato, Casafari lo configura en el plan Custom, con límites por contrato.

Si eres nuevo en Casafari: el uso se mide en unidades, igual por REST y MCP; las búsquedas de ubicación cuestan 0.

Gratuito: 1,000 unidades durante 30 días (prueba gratuita); 2 solicitudes en curso, 10 por minuto, 10 lugares al día.
Agente: 1,000 unidades por cada 3 horas móviles y 4,000 por cada 7 días móviles (ventanas de uso); 3 solicitudes en curso, 20 por minuto, 50 lugares al día, y un límite máximo de 50,000 unidades al día, una protección contra la extracción masiva de datos (límites). El uso adicional proviene solo de créditos prepagados, con un tope predeterminado de 25,000 unidades (€1,000, sin IVA) por período de suscripción.
Cuentas con créditos (sin plan o con suscripción cancelada): las protecciones de solicitudes del Agente y como máximo 25,000 unidades al día.
Personalizado: límites según contrato; "Contáctenos".

A través de REST, una ventana de Agente agotada sin créditos responde 429 usage_limit_reached con su tiempo de recarga, y quedarse sin unidades 402 payment_required; MCP responde con un error de pago (sin unidades). Una protección de solicitudes agotada responde 429 request_limit_reached con Retry-After. Cada límite está en Límites y ventanas de uso.

Enlace permanente: /docs/faq/rate-limits-and-quotas

¿Puedo leer estos documentos como Markdown, y existe un llms.txt?

Sí: añade .md a la URL de cualquier página o envía Accept: text/markdown, y /llms.txt indexa cada página y herramienta. Nada de esto requiere una clave.

/llms.txt es el índice, y /llms-full.txt contiene toda la referencia en un solo archivo.
/tools.json proporciona el nombre, título, esquema de entrada y esquema de salida de cada herramienta.
También encontrarás el catálogo de API, la tarjeta del servidor MCP, la habilidad de agente, el manifiesto de recursos agénticos y el mapa del sitio en /sitemap.xml.
Las respuestas en Markdown se sirven como text/markdown, con un encabezado x-markdown-tokens que estima su tamaño.
En un navegador que admita navigator.modelContext, las páginas registran estas herramientas WebMCP: search_casafari_mcp_docs, get_casafari_tool_reference, get_casafari_rest_operation, get_casafari_connection_config y open_casafari_docs_page.
La plataforma de autoservicio publica su propio https://platform.casafari.com/llms.txt y https://platform.casafari.com/llms-full.txt, además de un OpenAPI para cada producto.

Ver: Para agentes de IA.

Enlace permanente: /docs/faq/machine-readable-docs

Todas las preguntas