Quedaplaza

Disponibilidad con fecha, no un directorio.

Cada respuesta es una observación fechada, con el método por el que se obtuvo y un nivel de confianza. Tu cliente decide cuánta frescura necesita: max_data_age_hours=24 para un alta hospitalaria de mañana, 168 para una familia que planifica con margen.

Empezar
curl "https://quedaplaza.es/v1/search?near=Getafe&radius_km=25\
&room_type=PRIVATE&max_monthly_price_eur=2300&max_data_age_hours=48"

Las lecturas son abiertas. La ingesta de disponibilidad requiere clave. Contrato completo en /openapi.json.

Lo esencial
POST /v1/search

Busca por zona, presupuesto, habitación, estancia, características y frescura exigida. Devuelve además coverage: cuántos centros del entorno conocemos y cuántos no.

GET /v1/facilities/{id}

Ficha del centro, disponibilidad por línea de inventario y procedencia del dato.

POST /v1/availability/refresh-requests

Si una opción encaja pero su dato ha caducado, pide reconfirmación en lugar de presentarla como disponible.

GET /v1/stats/freshness

Qué parte del inventario está realmente al día. Publicado a propósito: si nuestra cobertura es pobre, deberías saberlo antes de confiar en ella.

Servidor MCP

Tres herramientas: find_available_care, get_facility y request_availability_refresh. El servidor declara en sus instrucciones que UNKNOWN significa «dato caducado», nunca «centro completo», y pide al agente citar cuándo se confirmó cada plaza. 

{
  "mcpServers": {
    "quedaplaza": {
      "command": "npx",
      "args": ["tsx", "src/mcp/main.ts"],
      "env": { "STORAGE": "postgres", "DATABASE_URL": "…" }
    }
  }
}
WebMCP

Las páginas de Quedaplaza exponen sus propias herramientas al agente que vive en el navegador, sin que tenga que leer la pantalla ni adivinar dónde pulsar. La portada ofrece buscar_plazas_disponibles; el portal privado de cada centro ofrece además publicar_disponibilidad, de modo que una residencia que ya usa un asistente puede mantener sus plazas al día sin abrir nada.

Es mejora progresiva: si el navegador no implementa WebMCP, el script no hace nada y la página funciona igual. El estándar lo desarrolla el Web Machine Learning Community Group del W3C y hoy requiere Chrome con el origin trial activado.

Qué no vas a encontrar

Ni un solo dato personal o de salud. La búsqueda se expresa con características del servicio —unidad de memoria, alta dependencia, accesibilidad—, nunca con información de la persona que necesita la plaza. Si tu integración necesita enviarnos eso, algo está mal planteado.