MCP público para ChatGPT y agentes

Endpoint JSON-RPC: https://www.alquila.do/mcp/public. Compatible con ChatGPT (conector OAuth) y clientes MCP.

Búsqueda del marketplace

Las propiedades promocionadas salen primero (highlighted: true), igual que en el sitio. Cada búsqueda devuelve como máximo 8 resultados, sin paginación. El catálogo completo está en search_url (alquila.do), no en el MCP.

Throttle: 60 POST/min por IP (incluye handshake), 20 tools/call/min y 400 tools/call/día por IP. Escrituras autenticadas: 20/min por usuario.

Autenticación

Las herramientas de búsqueda del marketplace son públicas. Las de escritura piden OAuth (openid email profile write). El scope legado write equivale a manejar las propiedades del usuario y solo lo usa el conector de ChatGPT.

Herramientas

  • public_search_properties

    Busca propiedades publicadas activas en Alquila.do. No requiere cuenta. Las promocionadas (highlighted) salen primero. Devuelve como máximo 8 resultados, sin paginación; el resto está en search_url. Incluye título, precio, ubicación, tipo, highlighted y URL pública.

  • public_get_property_detail

    Detalle de una propiedad pública: fotos, amenities, contacto público y URL. Sin email de cuenta.

  • public_search_locations

    Busca ubicaciones en República Dominicana (provincia, municipio, sector). Cada resultado incluye country_id, province_id, municipality_id y neighborhood_id para public_create_rental_unit. No asumas country_id=1.

  • public_generate_search_url

    Genera una URL de búsqueda en el marketplace de Alquila.do con filtros.

  • public_list_property_types

    Lista tipos de propiedad disponibles en Alquila.do (apartamento, casa, terreno, etc.).

  • public_list_countries

    Lista países activos. Usa el id (country_id) al crear una propiedad. En Alquila.do el país habitual es República Dominicana (code DO).

  • public_list_currencies

    Lista monedas activas para precios de propiedades.

  • public_list_amenities

    Lista amenities disponibles agrupadas por categoría para asignar a propiedades.

  • public_get_auth_status

    Verifica si hay un usuario autenticado vía OAuth y devuelve URLs para conectar cuenta o registrarse.

  • public_create_rental_unit

    Crea una propiedad en borrador (status unlisted). Requiere OAuth del propietario. country_id es opcional si envías province_id (se infiere). Si envías rent_price/selling_price sin moneda, se usa DOP por defecto.

  • public_update_rental_unit

    Actualiza una propiedad del usuario autenticado. Requiere OAuth. Si envías rent_price/selling_price sin moneda, se usa DOP por defecto.

  • public_upload_photos

    Sube fotos adjuntas de ChatGPT a una propiedad. Máximo 10, 5 MB c/u. Requiere OAuth. Pasa los archivos del usuario en photos (ChatGPT rellena download_url y file_id).

  • public_publish_rental_unit

    Publica una propiedad (status available) si cumple validaciones del wizard. Requiere OAuth.

  • public_my_properties

    Lista las propiedades del usuario autenticado. Requiere OAuth.

  • public_get_listing_quality

    Devuelve el índice de calidad de un listing del propietario (mismo score que /propietario/propiedades/:slug). Llama este tool después de actualizar o subir fotos para ver si el porcentaje mejoró. Requiere OAuth.

  • public_render_listings_widget

    Muestra cards de propiedades en ChatGPT. Llama primero public_search_properties o public_get_property_detail y pasa listings (id, title, price, url, image_url, location).