Fixatia

Buscar propiedades en subastas con dificultades para inversores

Ver en fixatia.comPrueba este MCPPatrocinado

Documentación

Integración del Servidor MCP

Conecta Claude y otros asistentes de IA a la base de datos de propiedades de Fixatia mediante el Protocolo de Contexto de Modelos (MCP)

¿Qué es MCP?

El Protocolo de Contexto de Modelos (MCP) es un estándar abierto que permite a asistentes de IA como Claude acceder de forma segura a fuentes de datos externas. El servidor MCP de Fixatia proporciona acceso en tiempo real a nuestra base de datos de subastas de propiedades europeas, permitiendo a los asistentes de IA buscar propiedades, recuperar detalles y descubrir filtros disponibles.

Busca miles de propiedades en subasta en 6 países europeos con filtros avanzados

Obtén detalles completos de propiedades, incluyendo estimaciones de renovación, cálculos de ROI y descripciones multilingües

Descubre dinámicamente las opciones de filtro disponibles para construir consultas de búsqueda potentes

Más información sobre MCP

Inicio Rápido

1URL del Servidor

El servidor MCP de Fixatia está disponible en:

https://mcp.fixatia.com/api/mcp

2Configurar Claude Desktop

Añade lo siguiente a tu archivo de configuración de Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fixatia": {
      "url": "https://mcp.fixatia.com/api/mcp"
    }
  }
}

3Empezar a Usar

Reinicia Claude Desktop y comienza a preguntar sobre propiedades. Claude utilizará automáticamente las herramientas de Fixatia para buscar y recuperar información de propiedades.

Prueba a preguntar: "Encuéntrame propiedades en Portugal por menos de 150.000 € con al menos un 20% de potencial de ROI"

Herramientas Disponibles

El servidor MCP de Fixatia proporciona cuatro herramientas potentes para interactuar con nuestra base de datos de propiedades:

search_properties

Busca propiedades de subasta inmobiliaria en toda Europa. Filtra por país, ciudad, precio, tipo de propiedad, potencial de ROI y más. Devuelve una lista de propiedades coincidentes con detalles clave, incluyendo precios de subasta, valores de mercado y métricas de inversión.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
query	string	Opcional	Búsqueda de texto por título de propiedad, ciudad o región
country	string	Opcional	Código de país: es (España), pt (Portugal), it (Italia), fr (Francia), de (Alemania), hr (Croacia)
region	string	Opcional	Nombre de la región dentro del país
city	string	Opcional	Nombre de la ciudad
propertyType	string	Opcional	Tipo de propiedad: APARTMENT, HOUSE, VILLA, LAND o COMMERCIAL
minPrice	number	Opcional	Precio mínimo de subasta en EUR
maxPrice	number	Opcional	Precio máximo de subasta en EUR
minRoi	number	Opcional	Porcentaje mínimo de ROI (por ejemplo, 20 para 20%)
bedrooms	number	Opcional	Número mínimo de dormitorios
maxResults	number	Opcional	Número máximo de resultados a devolver (por defecto: 10, máximo: 50)
sortBy	string	Opcional	Orden de clasificación: newest, price-low, price-high, roi-high o auction-soonest
locale	string	Opcional	Idioma para títulos/descripciones (por defecto: en). Soporta 18 idiomas.

Ejemplo de Solicitud

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_properties",
    "arguments": {
      "country": "pt",
      "maxPrice": 150000,
      "minRoi": 20,
      "maxResults": 5
    }
  },
  "id": 1
}

Ejemplo de Respuesta

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": {
        "totalCount": 12,
        "results": [
          {
            "id": "b45dc4fc14134da69e9f800f8",
            "title": "2-Bedroom Apartment · Lisbon",
            "country": "pt",
            "city": "Lisboa",
            "propertyType": "APARTMENT",
            "auctionPrice": 120000,
            "marketValue": 165000,
            "potentialRoi": 26.5,
            "bedrooms": 2,
            "squareMeters": 75
          }
        ]
      }
    }]
  }
}

get_property

Obtén los detalles completos de una propiedad específica por su ID. Devuelve información exhaustiva, incluyendo descripciones multilingües, imágenes, coordenadas de ubicación, estimaciones de renovación, detalles de subasta y métricas de inversión.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
id	string	Obligatorio	El ID de la propiedad (obtenido de los resultados de búsqueda)
locale	string	Opcional	Idioma para título/descripción (por defecto: en). Soporta 18 idiomas.

Ejemplo de Solicitud

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_property",
    "arguments": {
      "id": "b45dc4fc14134da69e9f800f8",
      "locale": "en"
    }
  },
  "id": 2
}

get_filter_options

Obtén las opciones de filtro disponibles, incluyendo la lista de países, regiones, ciudades, tipos de propiedad y rangos de precio/ROI. Útil para entender qué parámetros de búsqueda están disponibles y para construir interfaces de filtro dinámicas.

Esta herramienta no acepta parámetros.

Ejemplo de Solicitud

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_filter_options",
    "arguments": {}
  },
  "id": 3
}

Ejemplo de Respuesta

{
  "countries": [
    { "code": "pt", "name": "Portugal", "propertyCount": 45 },
    { "code": "es", "name": "Spain", "propertyCount": 120 },
    { "code": "it", "name": "Italy", "propertyCount": 89 }
  ],
  "propertyTypes": [
    { "type": "APARTMENT", "count": 156 },
    { "type": "HOUSE", "count": 78 }
  ],
  "priceRange": { "min": 5000, "max": 800000 },
  "roiRange": { "min": -5, "max": 45 }
}

send_property_inquiry

OAuth 2.1

Envía una consulta sobre una propiedad para expresar interés. Esta herramienta requiere autenticación OAuth 2.1 con PKCE.

Autenticación Requerida (OAuth 2.1)

Esta herramienta utiliza OAuth 2.1 con PKCE para una autenticación segura. El flujo es:

El usuario hace clic en 'Autorizar' e inicia sesión mediante una ventana emergente del navegador
El código de autorización se intercambia por un token de acceso (protegido por PKCE)
mcp.tools.sendPropertyInquiry.oauthStep3

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
propertyId	string	Obligatorio	El ID de la propiedad sobre la que consultar
message	string	Obligatorio	Tu mensaje de consulta, mínimo 10 caracteres

Ejemplo de Solicitud

// Requires Bearer token authentication
// curl -X POST https://mcp.fixatia.com/api/mcp \
//   -H "Authorization: Bearer YOUR_TOKEN" \
//   -H "Content-Type: application/json" \
//   -d '...'

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "send_property_inquiry",
    "arguments": {
      "propertyId": "b45dc4fc14134da69e9f800f8",
      "message": "I'm interested in this property. Is it still available?"
    }
  },
  "id": 4
}

Ejemplo de Respuesta

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [{
      "type": "text",
      "text": "Inquiry sent successfully! The property owner will be notified and may contact you."
    }]
  }
}

Referencia de la API HTTP

El servidor MCP también expone una API HTTP directa para acceso programático. Todas las solicitudes utilizan el protocolo JSON-RPC 2.0.

Endpoints

GET

/api/mcp

Comprobación de estado e información del servidor. Devuelve el nombre del servidor, versión, versión del protocolo y herramientas disponibles.

POST

/api/mcp

Solicitudes JSON-RPC 2.0 para la ejecución de herramientas. Soporta los métodos initialize, tools/list, tools/call y ping.

Métodos Soportados

initialize - Inicializa la sesión MCP y obtén las capacidades del servidor
tools/list - Lista todas las herramientas disponibles con sus esquemas
tools/call - Ejecuta una herramienta específica con argumentos
ping - Comprobación de estado (ping)

Ejemplo con cURL

curl -X POST https://mcp.fixatia.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_properties",
      "arguments": {
        "country": "pt",
        "maxPrice": 150000
      }
    },
    "id": 1
  }'

Pruébalo

Prueba el servidor MCP directamente desde tu navegador. Selecciona una herramienta y configura los parámetros a continuación.

Selecciona una herramienta

Manejo de Errores

El servidor devuelve respuestas de error estándar JSON-RPC 2.0. Estos son los códigos de error comunes:

Código	Mensaje	Descripción
-32600	Invalid Request	El JSON enviado no es un objeto de Solicitud válido
-32601	Method not found	El método solicitado no existe o no está disponible
-32602	Invalid params	Parámetro(s) de método no válido(s): comprueba los campos y tipos obligatorios
-32603	Internal error	Error interno de JSON-RPC o problema en el servidor

Ejemplo de Respuesta de Error

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params: Property ID is required"
  }
}

Idiomas Soportados

Los títulos y descripciones de propiedades están disponibles en 18 idiomas. Usa el parámetro locale para obtener contenido en tu idioma preferido:

Inglés (en), Alemán (de), Francés (fr), Español (es), Italiano (it), Portugués (pt), Neerlandés (nl), Polaco (pl), Griego (el), Rumano (ro), Checo (cs), Húngaro (hu), Chino (zh), Árabe (ar), Ruso (ru), Japonés (ja), Coreano (ko), Croata (hr)

Documentación Legible por Máquina

Para asistentes de IA y herramientas automatizadas, proporcionamos archivos de documentación en texto plano que siguen el estándar llms.txt:

Más información sobre el estándar llms.txt en llmstxt.org

¿Necesitas Ayuda?

Si tienes preguntas sobre la integración con el servidor MCP de Fixatia o encuentras algún problema, nuestro equipo de soporte para desarrolladores está aquí para ayudarte.