MCP Radar
Servidor MCP

Subastech — subastas judiciales de inmuebles (BOE)

com.subastech/subastas-judiciales
Legal y cumplimiento Bienes raíces Búsqueda e investigación Público y accesible MCP 2025-11-25

Qué hace este MCP

Searches and analyzes Spanish BOE judicial real-estate auctions, with property details, viability reports, alerts, market statistics, favorites, registral notes, and paid checkout.

Capacidades

Herramientas

32 herramientas
alertas_activar
Activar o pausar una alerta
Activa o pausa una alerta tuya sin borrarla. Requiere cuenta verificada (scope `alertas:write`).
Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'activa'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la alerta (de `alertas_listar`).'}, 'activa': {'type': 'boolean', 'description': '`true` reanuda la alerta; `false` la pausa sin borrarla.'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'activa': {'type': 'boolean'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_crear
Crear una alerta
Crea una alerta de subastas (criterios, tipos de aviso, cadencia, canales). Requiere cuenta verificada (scope `alertas:write`). Envía un correo de confirmación al crearla. Límite de alertas y canales según el plan (`ajustes`). Previsualiza antes con `alertas_previsualizar`.
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['nombre', 'criterios', 'tipos', 'cadencia', 'canales'], 'properties': {'tipos': {'type': 'array', 'items': {'enum': ['new', 'price_drop', 'ending', 'status'], 'type': 'string'}, 'minItems': 1, 'description': '`new`, `price_drop`, `ending`, `status`'}, 'nombre': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Nombre de la alerta'}, 'canales': {'type': 'array', 'items': {'enum': ['inapp', 'email', 'push', 'telegram', 'webhook'], 'type': 'string'}, 'description': '`inapp` siempre; `email`; `push`/`telegram`/`webhook` según el plan'}, 'cadencia': {'enum': ['instant', 'daily', 'weekly'], 'type': 'string', 'description': '`instant` requiere plan Pro (si no, pasa a `daily`)'}, 'criterios': {'type': 'object', 'properties': {'m2Max': {'type': 'number', 'minimum': 0}, 'm2Min': {'type': 'number', 'minimum': 0}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'description': 'Palabras clave (máx. 10Ã\x9740). NO filtran por zona: usa provincia/municipio'}, 'occupied': {'type': 'boolean', 'description': 'Solo ocupadas (true) o solo libres (false)'}, 'priceMax': {'type': 'number', 'minimum': 0}, 'priceMin': {'type': 'number', 'minimum': 0}, 'scoreMin': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Scoring mÃ\xadnimo (0-100): requiere plan Pro'}, 'propertyTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 20, 'description': 'Valores EXACTOS del recurso `subastech://tipos-de-inmueble`'}, 'provinceSlugs': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 60, 'description': 'Slugs de provincia'}, 'discountMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Descuento mÃ\xadnimo sobre tasación (%): requiere plan Pro'}, 'priceDropMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Para el tipo `price_drop`: bajada mÃ\xadnima (%)'}, 'endingWithinDays': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Para el tipo `ending`: dÃ\xadas antes del fin'}, 'municipalityKeys': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 100, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas`)'}}, 'description': 'Filtros que debe cumplir una subasta para disparar la alerta: provincias, municipios, tipo de inmueble, precio, superficie y ocupación.', 'additionalProperties': False}, 'quiet_hours': {'type': 'object', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'days': {'type': 'array', 'items': {'type': 'integer', 'maximum': 6, 'minimum': 0}, 'maxItems': 7, 'description': '0 = domingo â\x80¦ 6 = sábado'}, 'from': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'paused': {'type': 'boolean'}}, 'description': 'Franja en la que no se envÃ\xadan avisos. `paused` la desactiva; `from` y `to` en formato HH:MM; `days` con 0 = domingo â\x80¦ 6 = sábado.', 'additionalProperties': False}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'url'], 'properties': {'id': {'type': 'string'}, 'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'avisos': {'type': 'array', 'items': {'type': 'object', 'required': ['message'], 'properties': {'fix': {}, 'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': {}}}, 'ajustes': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_editar
Editar una alerta
Modifica una alerta existente (nombre, criterios, tipos, cadencia, canales, horas de silencio). Requiere cuenta verificada (scope `alertas:write`). No envía correo.
Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'nombre', 'criterios', 'tipos', 'cadencia', 'canales'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la alerta a modificar (de `alertas_listar`).'}, 'tipos': {'type': 'array', 'items': {'enum': ['new', 'price_drop', 'ending', 'status'], 'type': 'string'}, 'minItems': 1, 'description': '`new`, `price_drop`, `ending`, `status`'}, 'nombre': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Nombre de la alerta'}, 'canales': {'type': 'array', 'items': {'enum': ['inapp', 'email', 'push', 'telegram', 'webhook'], 'type': 'string'}, 'description': '`inapp` siempre; `email`; `push`/`telegram`/`webhook` según el plan'}, 'cadencia': {'enum': ['instant', 'daily', 'weekly'], 'type': 'string', 'description': '`instant` requiere plan Pro (si no, pasa a `daily`)'}, 'criterios': {'type': 'object', 'properties': {'m2Max': {'type': 'number', 'minimum': 0}, 'm2Min': {'type': 'number', 'minimum': 0}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'description': 'Palabras clave (máx. 10Ã\x9740). NO filtran por zona: usa provincia/municipio'}, 'occupied': {'type': 'boolean', 'description': 'Solo ocupadas (true) o solo libres (false)'}, 'priceMax': {'type': 'number', 'minimum': 0}, 'priceMin': {'type': 'number', 'minimum': 0}, 'scoreMin': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Scoring mÃ\xadnimo (0-100): requiere plan Pro'}, 'propertyTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 20, 'description': 'Valores EXACTOS del recurso `subastech://tipos-de-inmueble`'}, 'provinceSlugs': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 60, 'description': 'Slugs de provincia'}, 'discountMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Descuento mÃ\xadnimo sobre tasación (%): requiere plan Pro'}, 'priceDropMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Para el tipo `price_drop`: bajada mÃ\xadnima (%)'}, 'endingWithinDays': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Para el tipo `ending`: dÃ\xadas antes del fin'}, 'municipalityKeys': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 100, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas`)'}}, 'description': 'Filtros que debe cumplir una subasta para disparar la alerta: provincias, municipios, tipo de inmueble, precio, superficie y ocupación.', 'additionalProperties': False}, 'quiet_hours': {'type': 'object', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'days': {'type': 'array', 'items': {'type': 'integer', 'maximum': 6, 'minimum': 0}, 'maxItems': 7, 'description': '0 = domingo â\x80¦ 6 = sábado'}, 'from': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'paused': {'type': 'boolean'}}, 'description': 'Franja en la que no se envÃ\xadan avisos. `paused` la desactiva; `from` y `to` en formato HH:MM; `days` con 0 = domingo â\x80¦ 6 = sábado.', 'additionalProperties': False}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'url'], 'properties': {'id': {'type': 'string'}, 'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'avisos': {'type': 'array', 'items': {'type': 'object', 'required': ['message'], 'properties': {'fix': {}, 'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': {}}}, 'ajustes': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_eliminar
Eliminar una alerta
Elimina una alerta tuya de forma permanente. Requiere cuenta verificada (scope `alertas:write`).
Destructivo Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la alerta a eliminar (de `alertas_listar`).'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_listar
Listar mis alertas
Lista tus alertas de subastas con sus criterios, tipos de aviso, cadencia, canales y estado. Requiere cuenta (scope `alertas:read`). Paginada (`pagina`, `por_pagina`; máximo 20 por página): usa `total`, `paginas` y `hasMore` para pedir la siguiente.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; 1 por defecto)'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20; 20 por defecto)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['alertas', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'total': {'type': 'number'}, 'pagina': {'type': 'number'}, 'alertas': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'nombre', 'criterios', 'tipos', 'cadencia', 'canales', 'activa'], 'properties': {'id': {'type': 'string'}, 'tipos': {'type': 'array', 'items': {'type': 'string'}}, 'activa': {'type': 'boolean'}, 'nombre': {'type': 'string'}, 'canales': {'type': 'array', 'items': {'type': 'string'}}, 'cadencia': {'type': 'string'}, 'criterios': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'descripcion': {'type': 'string'}, 'quiet_hours': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ultima_notificacion': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
alertas_previsualizar
Previsualizar una alerta
Antes de crear una alerta: cuántas subastas coinciden ahora con los criterios, una muestra y avisos con `fix` aplicable (criterios sospechosos). Requiere cuenta (scope `alertas:read`). Los criterios avanzados (`scoreMin`, `discountMinPct`) requieren plan Pro; si no, se ignoran y se informa en `ajustes`.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['criterios'], 'properties': {'criterios': {'type': 'object', 'properties': {'m2Max': {'type': 'number', 'minimum': 0}, 'm2Min': {'type': 'number', 'minimum': 0}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'description': 'Palabras clave (máx. 10Ã\x9740). NO filtran por zona: usa provincia/municipio'}, 'occupied': {'type': 'boolean', 'description': 'Solo ocupadas (true) o solo libres (false)'}, 'priceMax': {'type': 'number', 'minimum': 0}, 'priceMin': {'type': 'number', 'minimum': 0}, 'scoreMin': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Scoring mÃ\xadnimo (0-100): requiere plan Pro'}, 'propertyTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 20, 'description': 'Valores EXACTOS del recurso `subastech://tipos-de-inmueble`'}, 'provinceSlugs': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 60, 'description': 'Slugs de provincia'}, 'discountMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Descuento mÃ\xadnimo sobre tasación (%): requiere plan Pro'}, 'priceDropMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Para el tipo `price_drop`: bajada mÃ\xadnima (%)'}, 'endingWithinDays': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Para el tipo `ending`: dÃ\xadas antes del fin'}, 'municipalityKeys': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 100, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas`)'}}, 'description': 'Filtros que debe cumplir una subasta para disparar la alerta: provincias, municipios, tipo de inmueble, precio, superficie y ocupación.', 'additionalProperties': False}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['criterios_limpios', 'coinciden', 'muestra', 'avisos', 'ajustes'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'avisos': {'type': 'array', 'items': {'type': 'object', 'required': ['message'], 'properties': {'fix': {}, 'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': {}}}, 'ajustes': {'type': 'array', 'items': {'type': 'string'}}, 'muestra': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'coinciden': {'type': 'object', 'required': ['count', 'capped'], 'properties': {'count': {'type': 'number'}, 'capped': {'type': 'boolean'}}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'criterios_limpios': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': {}}
analisis_subasta
Análisis de una subasta (veredicto y ejes)
Veredicto de viabilidad y ejes (cargas, posesión, rentabilidad, titularidad) de una subasta. Requiere cuenta (scope `informes:read`) y plan Pro o superior; con Radar/Starter devuelve `locked` con `upgradeUrl`. No consume cuota.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subasta', 'analisis_listo', 'informe_url'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'ejes': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'locked': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'subasta': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'veredicto': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'informe_url': {'type': 'string'}, 'analisis_listo': {'type': 'boolean', 'description': 'false si polSaaS aún está generando el veredicto'}}, 'additionalProperties': {}}
buscar_por_codigo
Buscar por referencia catastral, CRU, IDUFIR o BOE
Localiza subastas del BOE a partir de códigos: referencia catastral, CRU, IDUFIR o identificador BOE (hasta 5). Pública, sin cuenta; sin cuenta solo devuelve fichas vigentes en el catálogo público (con cuenta, también las archivadas con `archivada: true`).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['codigos'], 'properties': {'codigos': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 3}, 'maxItems': 5, 'minItems': 1, 'description': 'Referencias catastrales, CRU, IDUFIR o identificadores BOE (1..5)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items', 'no_encontrados'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'archivada': {'type': 'boolean'}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}, 'no_encontrados': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}
buscar_subastas
Buscar subastas
Busca subastas judiciales de inmuebles del BOE por provincia, municipio, tipo, precio, superficie, texto libre, zona (bbox o radio) y estado. Pública, sin cuenta: devuelve datos oficiales del BOE y la URL de cada ficha. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`. Sin plan con scoring, `orden: score` pasa a `recent` y `solo_viables` se ignora (campo `degradado`). Máximo 20 por página (`por_pagina`, o su alias `limite`); no acepta parámetros que no estén declarados.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'bbox': {'type': 'object', 'required': ['oeste', 'sur', 'este', 'norte'], 'properties': {'sur': {'type': 'number'}, 'este': {'type': 'number'}, 'norte': {'type': 'number'}, 'oeste': {'type': 'number'}}, 'description': 'Zona rectangular en grados (lon/lat)', 'additionalProperties': False}, 'tipo': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 10, 'description': 'Tipos de inmueble, valores EXACTOS de `estadisticas_publicas.tipos` (p. ej. `Vivienda`, `Garaje`)'}, 'cerca': {'type': 'object', 'required': ['lat', 'lon', 'km'], 'properties': {'km': {'type': 'number', 'maximum': 50, 'exclusiveMinimum': 0}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180}}, 'description': 'Radio alrededor de un punto (máximo 50 km)', 'additionalProperties': False}, 'orden': {'enum': ['recent', 'ending', 'discount', 'price', 'score'], 'type': 'string', 'description': '`recent` (por defecto), `ending`, `discount`, `price`; `score` solo con plan Pro (si no, pasa a `recent`)'}, 'texto': {'type': 'string', 'maxLength': 120, 'description': 'Texto libre (calle, barrio, juzgadoâ\x80¦), máximo 120 caracteres'}, 'estado': {'enum': ['activas', 'todas', 'adjudicadas', 'desiertas'], 'type': 'string', 'description': '`activas` (por defecto), `todas`, `adjudicadas` o `desiertas`'}, 'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; máximo 25 sin cuenta, 50 con cuenta)'}, 'area_max': {'type': 'number', 'minimum': 0, 'description': 'Superficie construida máxima (m²)'}, 'area_min': {'type': 'number', 'minimum': 0, 'description': 'Superficie construida mÃ\xadnima (m²)'}, 'municipio': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 20, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas` con `municipio_q`)'}, 'provincia': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 10, 'description': 'Slugs de provincia (p. ej. [`madrid`, `barcelona`]); ver `estadisticas_publicas`'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20)'}, 'precio_max': {'type': 'number', 'minimum': 0, 'description': 'Valor de subasta máximo (euros)'}, 'precio_min': {'type': 'number', 'minimum': 0, 'description': 'Valor de subasta mÃ\xadnimo (euros)'}, 'solo_viables': {'type': 'boolean', 'description': 'Ocultar las no recomendables: solo con plan Pro (si no, se ignora)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'total': {'type': 'number'}, 'locked': {'type': 'object', 'properties': {'scoring': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'pagina': {'type': 'number'}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'degradado': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
cancel_checkout
Cancelar checkout (UCP)
Cancela una sesión de checkout UCP abierta (libera cualquier borrador de pedido). Una sesión completada o cancelada no cambia. Requiere meta['idempotency-key'] además de meta['ucp-agent'].
Destructivo Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a cancelar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}}}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
complete_checkout
Completar checkout (UCP)
Completa una sesión de checkout UCP. Sin manejador de pago nativo: si checkout.payment.instruments[] trae una credencial Shared Payment Token de Stripe (handler_id 'stripe', credential.token 'spt_…') se cobra y se entrega al instante; si no, la sesión pasa a requires_escalation y el comprador termina en continue_url. Un informe incluido en el plan se completa sin cobro. Requiere meta['idempotency-key'] además de meta['ucp-agent'].
Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a completar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}, 'checkout': {'type': 'object', 'properties': {'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'type': {'type': 'string', 'maxLength': 80}, 'selected': {'type': 'boolean'}, 'credential': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': {}}, 'handler_id': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': {}}, 'maxItems': 10}}, 'additionalProperties': {}}, 'signals': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'description': 'Datos finales del pedido si han cambiado. AquÃ\xad viaja la credencial de pago: un Shared Payment Token de Stripe en `payment.instruments[]` se cobra al instante.', 'additionalProperties': {}}}}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
create_checkout
Crear checkout (UCP)
Crea una sesión de checkout UCP 2026-08-25 para comprar un informe de viabilidad, una nota simple registral o una suscripción de Subastech. Productos (item.id): informe:basico:<publicId> (49 € o incluido según plan), informe:completo:<publicId> (79 € o incluido), nota-simple:<publicId> o nota-simple:cru:<14 dígitos> (20 €, solo se cobra con el PDF verificado) y plan:<starter|pro|team|enterprise>:<month|year> (la suscripción se completa en el navegador). Un producto por sesión, quantity 1. Precios con IVA. Indica checkout.buyer.email: se crea o vincula la cuenta del comprador y recibe un enlace de acceso por correo (o autentícate con un token de Subastech). Devuelve el objeto Checkout (status, line_items, totals, messages, links). Requiere meta['ucp-agent'] = { profile: 'https://<plataforma>/.well-known/ucp' } (identificación de la plataforma UCP).
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'checkout'], 'properties': {'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}, 'checkout': {'type': 'object', 'required': ['line_items'], 'properties': {'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'context': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'type': {'type': 'string', 'maxLength': 80}, 'selected': {'type': 'boolean'}, 'credential': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': {}}, 'handler_id': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': {}}, 'maxItems': 10}}, 'additionalProperties': {}}, 'signals': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['item'], 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'item': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Identificador del producto: informe:basico:<publicId>, informe:completo:<publicId>, nota-simple:<publicId>, nota-simple:cru:<14 dÃ\xadgitos> o plan:<key>:<month|year>'}}, 'additionalProperties': {}}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 1000000, 'minimum': 1}}, 'additionalProperties': {}}, 'maxItems': 10, 'minItems': 1}, 'attribution': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'description': 'Contenido del pedido: `line_items` con los productos del catálogo (1-10) y, opcionalmente, `buyer` y `payment`.', 'additionalProperties': {}}}}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
estadisticas_publicas
Estadísticas públicas del catálogo
Totales del catálogo, provincias con subastas activas e históricas, tipos de inmueble (valores EXACTOS para filtrar) y búsqueda de municipios (claves `provincia:municipio`). Pública, sin cuenta. No incluye estadísticas de mercado (herramienta `mercado`, plan Pro).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'estado': {'enum': ['activas', 'historicas'], 'type': 'string', 'description': 'Ã\x81mbito de los tipos de inmueble'}, 'municipio_q': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': 'Buscar municipios por nombre (â\x89¥2 caracteres)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['totales', 'provincias', 'tipos'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'tipos': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'n'], 'properties': {'n': {'type': 'number'}, 'type': {'type': 'string'}}, 'additionalProperties': {}}}, 'totales': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'municipios': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'name', 'province', 'auctionCount', 'url'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'province': {'type': 'string'}, 'auctionCount': {'type': 'number'}}, 'additionalProperties': {}}}, 'provincias': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'active', 'historical', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'active': {'type': 'number'}, 'historical': {'type': 'number'}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
explicar_concepto
Explicar un concepto de subastas judiciales
Explica un concepto de las subastas judiciales en España (depósito, cargas, posesión, cesión de remate, tipos de subasta…) desde la base de conocimiento de Subastech, redactada por personas. Pública, sin cuenta; sin modelo de lenguaje.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pregunta'], 'properties': {'pregunta': {'type': 'string', 'maxLength': 400, 'minLength': 2, 'description': 'Concepto o pregunta (p. ej. «qué es la cesión de remate»)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['concepto'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'fuente': {'type': 'string'}, 'concepto': {'anyOf': [{'type': 'object', 'required': ['id', 'respuesta_md'], 'properties': {'id': {'type': 'string'}, 'titulo': {'type': 'string'}, 'respuesta_md': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'disclosure': {'type': 'string'}, 'sugerencia': {'type': 'string'}, 'relacionados': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}
favoritos_anadir
Guardar en favoritos
Guarda una subasta en tus favoritos. Requiere cuenta (scope `favoritos:write`). Radar y Starter solo pueden guardar subastas activas (`fav.historico` es Pro+).
Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'favorito'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'favorito': {'type': 'boolean'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
favoritos_listar
Listar mis favoritos
Subastas que has guardado como favoritas. Requiere cuenta (scope `favoritos:read`). Paginada (`pagina`, `por_pagina`; máximo 20 por página): usa `total`, `paginas` y `hasMore` para pedir la siguiente. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; 1 por defecto)'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20; 20 por defecto)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'total': {'type': 'number'}, 'pagina': {'type': 'number'}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
favoritos_quitar
Quitar de favoritos
Quita una subasta de tus favoritos. Requiere cuenta (scope `favoritos:write`).
Destructivo Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'favorito'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'favorito': {'type': 'boolean'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
fetch
Fetch (ChatGPT)
Lee una ficha de subasta por `id` (compatible con la búsqueda profunda de ChatGPT): `id`, `title`, `text` con los datos públicos del BOE en Markdown, `url` y `metadata`. Pública, sin cuenta. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 400, 'minLength': 1, 'description': '`id` devuelto por `search` (o URL de la ficha)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'title', 'text', 'url', 'metadata'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_checkout
Consultar checkout (UCP)
Devuelve el estado actual de una sesión de checkout UCP por id (incomplete, ready_for_complete, requires_escalation, complete_in_progress, completed, canceled), con messages, continue_url y order cuando existan. Requiere meta['ucp-agent'] = { profile: 'https://<plataforma>/.well-known/ucp' } (identificación de la plataforma UCP).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a consultar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}}}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
informe
Informe de viabilidad
Informe de viabilidad de una subasta con las secciones que tu plan permite (resumen, cargas, descripción, catastro, calculadora, valoración, intervinientes, estadísticas); las cerradas se listan en `locked`. Requiere cuenta verificada (scope `informes:read`). Los tiers `basic`/`completo` solo se sirven si ya están desbloqueados: si no, devuelve `unlock_required` con la URL para desbloquearlos en el navegador (y, si el comercio para agentes está activo, `compra.paymentLink` para pagarlos por MPP). Nunca consume cuota ni cobra por sí misma. Parte del texto se genera con IA (`disclosure`).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}, 'tier': {'enum': ['web', 'basic', 'completo'], 'type': 'string', 'description': '`web` (por defecto, según tu plan), `basic` o `completo` (solo si ya están desbloqueados)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subasta', 'tier', 'secciones', 'locked', 'analisis_listo', 'informe_url'], 'properties': {'ai': {'type': 'object', 'required': ['generated', 'system'], 'properties': {'note': {'type': 'string'}, 'system': {'type': 'string'}, 'generated': {'type': 'boolean'}}, 'additionalProperties': {}}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'tier': {'enum': ['web', 'basic', 'completo'], 'type': 'string'}, 'compra': {'type': 'object', 'required': ['paymentLink', 'precio_cents', 'moneda', 'instrucciones'], 'properties': {'moneda': {'type': 'string', 'const': 'EUR'}, 'paymentLink': {'type': 'string', 'description': 'URL de pago máquina (MPP/Stripe): POST â\x86\x92 402 con reto â\x86\x92 reintento con Shared Payment Token; en navegador, checkout humano'}, 'precio_cents': {'type': 'number'}, 'precio_label': {'type': 'string'}, 'instrucciones': {'type': 'object', 'required': ['agente', 'navegador'], 'properties': {'agente': {'type': 'string'}, 'navegador': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'locked': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'pdfUrl': {'type': 'string'}, 'subasta': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'secciones': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'unlock_url': {'type': 'string'}, 'informe_url': {'type': 'string'}, 'analisis_listo': {'type': 'boolean', 'description': 'false si polSaaS aún está generando el veredicto'}}, 'additionalProperties': {}}
mercado
Estadísticas de mercado
Estadísticas de mercado de subastas resueltas (tasa de adjudicación, descuento real, precios) por provincia y/o tipo de inmueble. Requiere cuenta (scope `informes:read`) y plan Pro o superior; si no, `plan_required` con `locked`.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'tipo': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': 'Tipo de inmueble (valor exacto)'}, 'provincia': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ambito', 'stats'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'stats': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ambito': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'locked': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'minimo': {'type': 'number'}, 'disclosure': {'type': 'string'}, 'muestra_insuficiente': {'type': 'boolean'}}, 'additionalProperties': {}}
mi_cuenta
Mi cuenta
Tu plan, cuota de informes, funciones disponibles, scopes del token, límites de uso y URLs útiles (precios, integraciones). Requiere cuenta (scope `cuenta:read`).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['usuario', 'plan', 'funciones', 'token', 'limites', 'urls'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'org': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'plan': {'type': 'object', 'required': ['key', 'nombre'], 'properties': {'key': {'type': 'string'}, 'nombre': {'type': 'string'}, 'precio_mes': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'urls': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'token': {'type': 'object', 'required': ['kind', 'scopes'], 'properties': {'kind': {'type': 'string'}, 'client': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'scopes': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}, 'limites': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'usuario': {'type': 'object', 'required': ['email', 'nombre', 'verificado'], 'properties': {'email': {'type': 'string'}, 'nombre': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verificado': {'type': 'boolean'}}, 'additionalProperties': {}}, 'funciones': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'boolean'}}, 'disclosure': {'type': 'string'}, 'cuota_informes': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': {}}
nota_simple_estado
Estado de una nota simple
Estado de un pedido de nota simple registral y URL para verlo o descargar el PDF cuando esté listo. Requiere cuenta (scope `notas:read`).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedido_id'], 'properties': {'pedido_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador del pedido devuelto por `nota_simple_pedir`.'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedido', 'url'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'pedido': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
nota_simple_pedir
Pedir una nota simple
Inicia el pedido de la nota simple registral de una subasta (20 €, retención: solo se cobra con PDF verificado). Requiere cuenta verificada (scope `notas:write`) y que la subasta tenga CRU/IDUFIR (`not_orderable` si no). Devuelve `pedido_id` y la `url` donde el usuario confirma el pago en el navegador (y, si el comercio para agentes está activo, `paymentLink` para pagarlo por MPP); el pago nunca se completa desde aquí. Idempotente: si ya hay un pedido vivo devuelve `pedido_existente`. Máximo 20 inmuebles al día.
Acceso externo Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedido_id', 'url', 'siguiente_paso'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'compra': {'type': 'object', 'required': ['paymentLink', 'precio_cents', 'moneda', 'instrucciones'], 'properties': {'moneda': {'type': 'string', 'const': 'EUR'}, 'paymentLink': {'type': 'string', 'description': 'URL de pago máquina (MPP/Stripe): POST â\x86\x92 402 con reto â\x86\x92 reintento con Shared Payment Token; en navegador, checkout humano'}, 'precio_cents': {'type': 'number'}, 'precio_label': {'type': 'string'}, 'instrucciones': {'type': 'object', 'required': ['agente', 'navegador'], 'properties': {'agente': {'type': 'string'}, 'navegador': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'pedido_id': {'type': 'string'}, 'disclosure': {'type': 'string'}, 'paymentLink': {'type': 'string'}, 'precio_cents': {'type': 'number'}, 'siguiente_paso': {'type': 'string'}}, 'additionalProperties': {}}
notas_simples_listar
Listar mis notas simples
Pedidos de nota simple registral (20 €) con su estado. Requiere cuenta (scope `notas:read`). Paginada (`pagina`, `por_pagina`; máximo 20 por página): usa `total`, `paginas` y `hasMore` para pedir la siguiente.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; 1 por defecto)'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20; 20 por defecto)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedidos', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'total': {'type': 'number'}, 'pagina': {'type': 'number'}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'pedidos': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
planes
Planes y precios de Subastech
Planes de Subastech (Radar gratuito, Starter, Pro, Team, Enterprise) con precios y comparativa de funciones. Pública, sin cuenta.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['planes', 'comparativa', 'url'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'planes': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}, 'comparativa': {}}, 'additionalProperties': {}}
recomendaciones
Recomendaciones para ti
Subastas recomendadas según tu historial (tipo, precio, provincias), como el bloque «para ti» de la web. Requiere cuenta (scope `cuenta:read`). Con plan Pro o superior usa el ranking por scoring; si no, se construye con tu perfil y orden por fecha de fin.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'nota': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'titulo': {'type': 'string'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
resultados_recientes
Adjudicaciones recientes
Últimas subastas del BOE con resultado oficial (adjudicadas), opcionalmente por provincia, con el remate y el descuento real sobre la tasación (aritmética del BOE). Pública, sin cuenta. Máximo 15.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 15, 'minimum': 1, 'description': 'Máximo 15'}, 'provincia': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente', 'remate', 'descuento_real_pct'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'remate': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'descuento_real_pct': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
search
Search (ChatGPT)
Búsqueda en lenguaje natural de subastas judiciales del BOE (compatible con la búsqueda profunda de ChatGPT): devuelve `results` con `id`, `title` y `url`. Pública, sin cuenta. Usa `fetch` con el `id` para leer la ficha.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Búsqueda en lenguaje natural'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
similares
Subastas similares
Subastas parecidas a una dada (mismo tipo de inmueble, banda de precio, cercanía). Requiere cuenta (scope `informes:read`). Con plan Pro o superior se ordenan por scoring (`metodo: scoring`); si no, por fecha de fin (`metodo: publico`).
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}, 'limite': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Número máximo de subastas similares a devolver (1-10).'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['base', 'items', 'metodo'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'base': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'metodo': {'enum': ['scoring', 'publico'], 'type': 'string'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
subasta
Ficha de una subasta
Ficha pública de una subasta del BOE por identificador (10 caracteres), URL de app.subastech.com o identificador BOE (SUB-…): dirección, valores, fechas, resultado, lotes y un resumen citable. Pública, sin cuenta. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`.
Solo lectura Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}, 'url': {'type': 'string', 'format': 'uri', 'maxLength': 400, 'description': 'URL de la ficha en app.subastech.com'}, 'boe_id': {'type': 'string', 'maxLength': 60, 'description': 'Identificador del BOE (p. ej. `SUB-JA-2026-123456`): devuelve todos los lotes'}}, 'additionalProperties': False}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subasta', 'resumen'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'lotes': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'locked': {'type': 'object', 'properties': {'scoring': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'resumen': {'type': 'string', 'description': 'Frase citable con los datos del BOE'}, 'subasta': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
update_checkout
Actualizar checkout (UCP)
Reemplaza el contenido de una sesión de checkout UCP (line_items y buyer) y recalcula precio y estado. No admite sesiones en complete_in_progress ni terminadas. Requiere meta['ucp-agent'] = { profile: 'https://<plataforma>/.well-known/ucp' } (identificación de la plataforma UCP).
Idempotente
Esquema de entrada 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id', 'checkout'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a modificar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}, 'checkout': {'type': 'object', 'required': ['line_items'], 'properties': {'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'context': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'type': {'type': 'string', 'maxLength': 80}, 'selected': {'type': 'boolean'}, 'credential': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': {}}, 'handler_id': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': {}}, 'maxItems': 10}}, 'additionalProperties': {}}, 'signals': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['item'], 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'item': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Identificador del producto: informe:basico:<publicId>, informe:completo:<publicId>, nota-simple:<publicId>, nota-simple:cru:<14 dÃ\xadgitos> o plan:<key>:<month|year>'}}, 'additionalProperties': {}}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 1000000, 'minimum': 1}}, 'additionalProperties': {}}, 'maxItems': 10, 'minItems': 1}, 'attribution': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'description': 'Nuevo contenido del pedido, que sustituye al de la sesión abierta.', 'additionalProperties': {}}}}
Esquema de salida 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
Historial

Cambios recientes en herramientas

Añadido
cancel_checkout
17 de September de 2026 a las 12:37
Añadido
complete_checkout
17 de September de 2026 a las 12:37
Añadido
update_checkout
17 de September de 2026 a las 12:37
Añadido
get_checkout
17 de September de 2026 a las 12:37
Añadido
create_checkout
17 de September de 2026 a las 12:37
Añadido
nota_simple_pedir
17 de September de 2026 a las 12:37
Añadido
nota_simple_estado
17 de September de 2026 a las 12:37
Añadido
notas_simples_listar
17 de September de 2026 a las 12:37
Añadido
mi_cuenta
17 de September de 2026 a las 12:37
Añadido
favoritos_quitar
17 de September de 2026 a las 12:37
Añadido
favoritos_anadir
17 de September de 2026 a las 12:37
Añadido
favoritos_listar
17 de September de 2026 a las 12:37
Añadido
alertas_activar
17 de September de 2026 a las 12:37
Añadido
alertas_eliminar
17 de September de 2026 a las 12:37
Añadido
alertas_editar
17 de September de 2026 a las 12:37
Añadido
alertas_crear
17 de September de 2026 a las 12:37
Añadido
alertas_previsualizar
17 de September de 2026 a las 12:37
Añadido
alertas_listar
17 de September de 2026 a las 12:37
Añadido
mercado
17 de September de 2026 a las 12:37
Añadido
recomendaciones
17 de September de 2026 a las 12:37
Añadido
similares
17 de September de 2026 a las 12:37
Añadido
informe
17 de September de 2026 a las 12:37
Añadido
analisis_subasta
17 de September de 2026 a las 12:37
Añadido
fetch
17 de September de 2026 a las 12:37
Añadido
search
17 de September de 2026 a las 12:37
Añadido
planes
17 de September de 2026 a las 12:37
Añadido
explicar_concepto
17 de September de 2026 a las 12:37
Añadido
estadisticas_publicas
17 de September de 2026 a las 12:37
Añadido
resultados_recientes
17 de September de 2026 a las 12:37
Añadido
buscar_por_codigo
17 de September de 2026 a las 12:37
Descubrir

Servidores MCP similares

BNM Data Shop

io.github.bnmbnmai/bnm-data-shop

Sells access to cached official reports, enforcement orders, regulatory documents, inspection records, and other public-source te…

US Company Intelligence for AI Agents (SEC EDGAR, x402)

online.x-402/mcp

Offers pay-per-call web extraction, search and LLM tools plus French company, property, procurement, marketplace and security dat…

Dados Abertos Senado BR MCP

io.github.SidneyBissoli/senado-br-mcp-cloudflare

Searches and retrieves Brazilian Federal Senate legislative, administrative, budgetary, contracting, speech, committee, and e-Cid…

OpenHelvetia Gateway

swiss.openhelvetia/gateway

Provides sourced access to Swiss federal legislation and political data, including law metadata, versions, amendments, citations,…

GleanMark Trademark Search

com.gleanmark/trademark-search

Searches and analyzes USPTO trademark records, including conflicts, prosecution histories, TTAB proceedings, ownership chains, de…

editalmd

com.editalmd/editalmd

Searches Brazilian public procurement opportunities and documents, tracks deadlines and alerts, and supports tender document acce…

DataNexus MCP

com.datanexusmcp/mcp-server

Enables public-data research across domains, patents, government contracts, nonprofits, compliance registries, and software secur…

agentdata-nl

io.github.DarthSander/agentdata-nl

Provides paid company, insolvency, sanctions, regulatory, crypto-market, news, payment-counterparty, and structured web research …