Fixatia
Para Desarrolladores

Integración del Servidor MCP

Conecta Claude y otros asistentes de IA a la base de datos de propiedades de Fixatia utilizando el Protocolo de Contexto del Modelo

¿Qué es MCP?

El Protocolo de Contexto del Modelo (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 la propiedad, 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 poderosas

Aprende más 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

Agrega 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"
    }
  }
}

3Comenzar 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 sobre propiedades.

Intenta preguntar: "Encuéntrame propiedades en Portugal por debajo de €150,000 con al menos un 20% de potencial de ROI"

Herramientas Disponibles

El servidor MCP de Fixatia proporciona tres herramientas poderosas para interactuar con nuestra base de datos de propiedades:

buscar_propiedades

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, incluidos precios de subasta, valores de mercado y métricas de inversión.

Parámetros

ParameterTypeRequiredDescription
querystringOpcionalBúsqueda de texto para el título de la propiedad, ciudad o región
countrystringOpcionalCódigo de país: es (España), pt (Portugal), it (Italia), fr (Francia), de (Alemania), hr (Croacia)
regionstringOpcionalNombre de la región dentro del país
citystringOpcionalNombre de la ciudad
propertyTypestringOpcionalTipo de propiedad: APARTAMENTO, CASA, VILLA, TERRENO o COMERCIAL
minPricenumberOpcionalPrecio mínimo de subasta en EUR
maxPricenumberOpcionalPrecio máximo de subasta en EUR
minRoinumberOpcionalPorcentaje mínimo de ROI (por ejemplo, 20 para 20%)
bedroomsnumberOpcionalNúmero mínimo de dormitorios
maxResultsnumberOpcionalNúmero máximo de resultados a devolver (predeterminado: 10, máximo: 50)
sortBystringOpcionalOrden de clasificación: más nuevo, precio-bajo, precio-alto, roi-alto o subasta-pronto
localestringOpcionalIdioma para títulos/descripciones (predeterminado: 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
          }
        ]
      }
    }]
  }
}

obtener_propiedad

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

Parámetros

ParameterTypeRequiredDescription
idstringRequeridoEl ID de la propiedad (obtenido de los resultados de búsqueda)
localestringOpcionalIdioma para título/descripción (predeterminado: en). Soporta 18 idiomas.

Ejemplo de Solicitud

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

obtener_opciones_filtro

Obtén las opciones de filtro disponibles, incluyendo una 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 construir interfaces de filtro dinámicas.

Esta herramienta no toma 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 usa OAuth 2.1 con PKCE para autenticación segura. El flujo es:

  • El usuario hace clic en 'Autorizar' e inicia sesión en el navegador
  • El código de autorización se intercambia por token de acceso (protegido por PKCE)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Parámetros

ParameterTypeRequiredDescription
propertyIdstringRequeridoEl ID de la propiedad a consultar
messagestringRequeridoTu 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.

Puntos finales

GET
/api/mcp

Verificació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 métodos de inicialización, herramientas/lista, herramientas/llamada y ping.

Métodos Soportados

  • initialize - Inicializa la sesión MCP y obtiene las capacidades del servidor
  • tools/list - Lista todas las herramientas disponibles con sus esquemas
  • tools/call - Ejecuta una herramienta específica con argumentos
  • ping - Ping de verificación de estado

Ejemplo de 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.

Selecciona una herramienta

Manejo de Errores

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

CodeMessageDescription
-32600Solicitud InválidaEl JSON enviado no es un objeto de Solicitud válido
-32601Método no encontradoEl método solicitado no existe o no está disponible
-32602Parámetros inválidosParámetro(s) de método inválido(s) - verifica los campos y tipos requeridos
-32603Error internoError interno de JSON-RPC o problema del lado del 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 las propiedades están disponibles en 18 idiomas. Usa el parámetro de 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 siguiendo el estándar llms.txt:

llms.txt

Documentación concisa con URL del servidor, configuración y resúmenes de herramientas

llms-full.txt

Documentación completa incluyendo todos los parámetros, ejemplos de solicitudes/respuestas y códigos de error

Aprende más sobre el estándar llms.txt en llmstxt.org

¿Necesitas ayuda?

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

Contactar al soporte para desarrolladoresReportar un problema en GitHub