Endpoints: 76,849MCP servers: 32,730Payout addresses: 3,825Paid calls: 6,158Letters: 84Defects: 3,898counted just now
teppi

Server definition

Hash
sha256:6a75002d0554671ed3d9f0099e39bde1927fab33bccdc2783ce2d96654548357
What it is
What a remote MCP server returned when asked what it offers: 29 tools

The blob, as servednamed by its sha256

{ "instructions": "Subastas públicas de España (BOE judiciales, notariales, Seguridad Social, AEAT, ayuntamientos…). Las listas (buscar_bienes, buscar_por_codigo, listar_notificaciones, listar_favoritas) traen gratis una ficha reducida de cada bien con una línea resumen: ubicación sin número, importes y superficie redondeados (~), señales (ocupada, vivienda habitual, cargas, visitable) y el plazo aproximado del fin. Úsala para comparar y ayudar a elegir; lo exacto (dirección, referencias, autoridad, fechas, importes, URL oficial y documentos) está en ver_bien, cuya primera consulta de cada bien gasta 1 de la cuota mensual. No abras las fichas de todos los resultados: enseña la lista y pregunta al usuario cuáles quiere ver; si hay muchos más resultados que fichas disponibles, propón acotar la búsqueda. Los valores exactos de los filtros salen de listar_provincias, listar_municipios y opciones_filtros. Con la cuenta conectada (en prueba gratuita o con un plan en vigor) o con una key valen todas, con los cupos mensuales del plan (mi_cuenta los da). Sin cuenta, o con una cuenta sin plan, también se puede buscar: buscar_bienes dice cuántas subastas activas coinciden, pero solo se ven las finalizadas, con límites diarios; sin cuenta, las tools de cuenta y las subastas activas piden conectar la cuenta. buscar_por_codigo encuentra un bien por referencia catastral, IDUFIR/CRU o id del BOE. listar_notificaciones da los bienes que las alertas del usuario ya le han enviado, con filtros; marcar_notificaciones solo si el usuario lo pide. Para dudas de conceptos (depósito, cargas, cesión de remate…) usa explicar_concepto o lee el recurso alertasubastas://conceptos; antes de crear_alerta, alertas_previsualizar dice cuántas subastas activas coinciden. Los valores de los filtros están también en alertasubastas://filtros.", "tools": [ { "description": "Antes de crear_alerta: cuántas subastas activas coinciden ahora con esos filtros y una muestra de hasta 5 ids (las más recientes), para ajustar filtros demasiado estrechos o amplios. Mismos filtros y reglas de plan que crear_alerta. No crea nada ni consume cuota.", "inputSchema": { "additionalProperties": false, "properties": { "filtros": { "description": "Filtros de la alerta. Sin provincia la alerta es nacional (requiere un plan que lo incluya).", "properties": { "bienes_lote": { "description": "Bienes del lote: uno (lote de un solo bien) o varios.", "enum": [ "uno", "varios" ], "type": "string" }, "clase_subasta": { "description": "Origen de la subasta: 2 BOE judiciales, 3 notariales, 4 diputaciones, 5 ayuntamientos, 6 consejos comarcales, 7 Seguridad Social, 11 agencias tributarias autonómicas, 12 AEAT, 13 administraciones generales.", "type": "integer" }, "comarca": { "description": "Slug de comarca (\"maresme-barcelona\"), de la lista comarcas de listar_municipios. Excluyente con municipio.", "type": "string" }, "deposito": { "additionalProperties": false, "description": "Depósito requerido en euros: {min, max}.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "marca": { "description": "Marca del vehículo como slug (\"renault\", \"mercedes-benz\"); lista en opciones_filtros (marcas). Solo vehículos.", "type": "string" }, "municipio": { "description": "Nombre exacto del municipio, tal como lo devuelve listar_municipios.", "type": "string" }, "procedimiento": { "description": "Código de procedimiento (lista en opciones_filtros).", "type": "integer" }, "provincia": { "description": "Slug (\"a-coruna\") o nombre exacto (\"A Coruña\"). Lista en listar_provincias.", "type": "string" }, "reclamada": { "additionalProperties": false, "description": "Cantidad reclamada en euros: {min, max}, ambos incluidos. Es la del lote o, si no la hay, la de toda la subasta. Con el filtro quedan fuera los bienes sin cantidad reclamada.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "superficie": { "additionalProperties": false, "description": "Superficie en m² según catastro: {min, max} enteros, min incluido y max excluido. Construida; en solares y fincas rústicas, la de la parcela. Solo inmuebles; quedan fuera los bienes sin dato.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "texto_excluye": { "description": "Palabras que no debe contener el bien.", "maxLength": 255, "type": "string" }, "texto_incluye": { "description": "Palabras que debe contener el bien.", "maxLength": 255, "type": "string" }, "tipo_bien": { "description": "Obligatorio. Slug de opciones_filtros o un grupo: inmuebles, muebles, todos (los grupos requieren un plan que lo incluya).", "type": "string" }, "valoracion": { "additionalProperties": false, "description": "Valor de subasta en euros: {min, max}; basta uno de los dos.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "vivienda_habitual": { "description": "Si el inmueble es la vivienda habitual del deudor según el BOE.", "enum": [ "si", "no", "desconocido" ], "type": "string" } }, "required": [ "tipo_bien" ], "type": "object" } }, "required": [ "filtros" ], "type": "object" }, "name": "alertas_previsualizar", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "activas": { "type": "integer" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "filtros_aplicados": { "type": "object" }, "message": { "type": "string" }, "muestra": { "items": { "type": "string" }, "type": "array" }, "nota": { "type": "string" } }, "type": "object" } }, { "description": "Guarda un bien en favoritas. Cuenta en el límite mensual de altas de favoritas del plan; si ya era favorita no cuenta.", "inputSchema": { "additionalProperties": false, "properties": { "bien": { "description": "Id del bien (0x…) o su URL de alertasubastas.com.", "type": "string" }, "comentario": { "maxLength": 2048, "type": "string" } }, "required": [ "bien" ], "type": "object" }, "name": "anadir_favorita", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "bien": { "type": "string" }, "comentario": { "type": [ "string", "null" ] }, "creada": { "type": "string" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "estado": { "type": "string" }, "ficha": { "type": [ "object", "null" ] }, "message": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } }, { "description": "Borra una alerta. No devuelve el hueco de altas del mes.", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "Id de la alerta.", "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "borrar_alerta", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "message": { "type": "string" }, "ok": { "type": "boolean" } }, "type": "object" } }, { "description": "Busca bienes en subasta (BOE, notariales, Seguridad Social, AEAT, ayuntamientos…), 100 por página. Cada resultado trae gratis una ficha reducida con una línea resumen lista para mostrar: tipo, calle sin número, municipio, origen y procedimiento; superficie, valor, depósito y cantidad reclamada redondeados (~), década de construcción, si está ocupada, si es vivienda habitual, si tiene cargas y si es visitable, si hay pujas y el plazo aproximado del fin. Lo exacto (número y piso, referencias, autoridad, fechas e importes exactos, URL oficial y documentos) solo está en la ficha (ver_bien), que gasta 1 de la cuota mensual por ficha nueva; una ficha ya consultada sale en la lista con los datos exactos. Enseña la lista con el resumen, ayuda al usuario a comparar y pregúntale qué fichas quiere abrir; no llames a ver_bien para todos. Si hay más resultados que fichas disponibles (aviso), propón acotar la búsqueda. Los filtros de valor, depósito, cantidad reclamada y superficie se ajustan a los valores de la web (opciones_filtros) y las fechas a semanas completas: los límites aplicados vienen en filtros_aplicados. Consume 1 búsqueda de la cuota mensual del plan (repetir la misma búsqueda en 60 minutos, también para cambiar de página, es gratis). consultadas: los ids cuya ficha ya consultaste (ver_bien no gasta cuota con ellos).", "inputSchema": { "additionalProperties": false, "properties": { "filtros": { "description": "Filtros estructurados. Todos opcionales.", "properties": { "bienes_lote": { "description": "Bienes del lote: uno (lote de un solo bien) o varios.", "enum": [ "uno", "varios" ], "type": "string" }, "clase_subasta": { "description": "Origen de la subasta: 2 BOE judiciales, 3 notariales, 4 diputaciones, 5 ayuntamientos, 6 consejos comarcales, 7 Seguridad Social, 11 agencias tributarias autonómicas, 12 AEAT, 13 administraciones generales.", "type": "integer" }, "comarca": { "description": "Slug de comarca (\"maresme-barcelona\"), de la lista comarcas de listar_municipios. Excluyente con municipio.", "type": "string" }, "deposito": { "additionalProperties": false, "description": "Depósito requerido en euros: {min, max}.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "estado": { "description": "activas, celebrandose, finalizadas, proximas, suspendidas, canceladas, o un slug de estado concreto (activa_con_pujas…). Sin estado, en el MCP: activas y próximas apertura (si el plan las incluye), y en el API REST: todas menos próximas. Para subastas ya celebradas, pon finalizadas.", "type": "string" }, "fecha_actualizacion": { "additionalProperties": false, "description": "Último cambio de estado: {desde, hasta}, YYYY-MM-DD o ISO 8601.", "properties": { "desde": { "type": "string" }, "hasta": { "type": "string" } }, "type": "object" }, "fecha_celebracion": { "additionalProperties": false, "description": "Fecha de conclusión de la subasta: {desde, hasta} en YYYY-MM-DD.", "properties": { "desde": { "type": "string" }, "hasta": { "type": "string" } }, "type": "object" }, "fecha_insercion": { "additionalProperties": false, "description": "Fecha de publicación en AlertaSubastas: {desde, hasta}.", "properties": { "desde": { "type": "string" }, "hasta": { "type": "string" } }, "type": "object" }, "marca": { "description": "Marca del vehículo como slug (\"renault\", \"mercedes-benz\"); lista en opciones_filtros (marcas). Solo vehículos.", "type": "string" }, "municipio": { "description": "Nombre exacto del municipio, tal como lo devuelve listar_municipios.", "type": "string" }, "procedimiento": { "description": "Código de procedimiento (lista en opciones_filtros).", "type": "integer" }, "provincia": { "description": "Slug (\"a-coruna\") o nombre exacto (\"A Coruña\"). Lista en listar_provincias.", "type": "string" }, "pujas": { "description": "Estado de la puja del bien.", "enum": [ "importe", "importe_no_publicado", "secreta", "sin_pujas", "desconocida", "con_pujas" ], "type": "string" }, "reclamada": { "additionalProperties": false, "description": "Cantidad reclamada en euros: {min, max}, ambos incluidos. Es la del lote o, si no la hay, la de toda la subasta. Con el filtro quedan fuera los bienes sin cantidad reclamada.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "superficie": { "additionalProperties": false, "description": "Superficie en m² según catastro: {min, max} enteros, min incluido y max excluido. Construida; en solares y fincas rústicas, la de la parcela. Solo inmuebles; quedan fuera los bienes sin dato.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "tipo_bien": { "description": "Slug del tipo de bien (vivienda, garaje, local-comercial, vehiculo…) o un grupo: inmuebles, muebles, todos. Lista en opciones_filtros.", "type": "string" }, "valoracion": { "additionalProperties": false, "description": "Valor de subasta en euros: {min, max}; basta uno de los dos.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "vivienda_habitual": { "description": "Si el inmueble es la vivienda habitual del deudor según el BOE.", "enum": [ "si", "no", "desconocido" ], "type": "string" } }, "type": "object" }, "orden": { "description": "fecha_celebracion_asc|desc, fecha_insercion_asc|desc, fecha_actualizacion_asc|desc, valoracion_asc|desc, puja_asc|desc, deposito_asc|desc. Sin orden: relevancia.", "type": "string" }, "page": { "maximum": 100, "minimum": 1, "type": "integer" }, "q": { "description": "Texto libre (título, descripción, calle, referencias, marca/modelo…).", "maxLength": 200, "type": "string" } }, "type": "object" }, "name": "buscar_bienes", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "aviso": { "type": "string" }, "consultadas": { "items": { "type": "string" }, "type": "array" }, "cuota_busquedas": { "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "filtros_aplicados": { "description": "Filtros de importe, superficie o fecha que se han ajustado a los valores de la web, con el valor aplicado.", "type": "object" }, "ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "page": { "type": "integer" }, "per_page": { "type": "integer" }, "resultados": { "items": { "properties": { "anyo": { "type": [ "integer", "null" ] }, "aproximado": { "type": "boolean" }, "bienes_lote": { "type": "integer" }, "calle": { "type": [ "string", "null" ] }, "cargas": { "enum": [ "si", "no", "desconocido" ], "type": "string" }, "comarca": { "type": [ "string", "null" ] }, "consultada": { "type": "boolean" }, "decada_construccion": { "type": [ "integer", "null" ] }, "deposito": { "type": [ "number", "null" ] }, "estado": { "type": [ "string", "null" ] }, "fin": { "type": [ "string", "null" ] }, "fin_fecha": { "type": [ "string", "null" ] }, "id": { "type": "string" }, "marca": { "type": [ "string", "null" ] }, "modelo": { "type": [ "string", "null" ] }, "municipio": { "type": [ "string", "null" ] }, "ocupada": { "enum": [ "si", "no", "desconocido" ], "type": "string" }, "origen": { "type": [ "string", "null" ] }, "procedimiento": { "type": [ "string", "null" ] }, "provincia": { "type": [ "string", "null" ] }, "pujas": { "type": "string" }, "reclamada": { "type": [ "number", "null" ] }, "reclamada_sobre_valor": { "type": [ "integer", "null" ] }, "resumen": { "type": "string" }, "superficie_m2": { "type": [ "number", "null" ] }, "tipo": { "type": [ "string", "null" ] }, "titulo": { "type": [ "string", "null" ] }, "url": { "type": "string" }, "valor": { "type": [ "number", "null" ] }, "visitable": { "enum": [ "si", "no", "desconocido" ], "type": "string" }, "vivienda_habitual": { "enum": [ "si", "no", "desconocido" ], "type": "string" } }, "type": "object" }, "type": "array" }, "total": { "type": "integer" } }, "type": "object" } }, { "description": "Busca bienes por un identificador: referencia catastral, IDUFIR / CRU, referencia registral, id de subasta del BOE (SUB-…), id de la Seguridad Social o la AEAT, anuncio del BOE, bastidor o matrícula. Devuelve en qué campo coincide (con su valor solo si es exactamente el buscado o la ficha ya está consultada) y la ficha reducida de cada bien en ficha, como buscar_bienes; el detalle, con ver_bien. No consume cuota. Sin cuenta solo devuelve finalizadas y dice cuántas activas hay.", "inputSchema": { "additionalProperties": false, "properties": { "q": { "description": "El identificador; espacios, guiones y barras dan igual.", "maxLength": 80, "minLength": 5, "type": "string" } }, "required": [ "q" ], "type": "object" }, "name": "buscar_por_codigo", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "activas": { "type": "object" }, "consultadas": { "items": { "type": "string" }, "type": "array" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "q": { "type": "string" }, "resultados": { "items": { "properties": { "campo": { "type": "string" }, "ficha": { "type": [ "object", "null" ] }, "finalizada": { "type": "boolean" }, "id": { "type": "string" }, "valor": { "description": "El valor del campo que coincide: solo si es exactamente el buscado o la ficha ya está consultada.", "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "total": { "type": "integer" } }, "type": "object" } }, { "description": "Fija el comentario de una favorita; vacío o null lo borra.", "inputSchema": { "additionalProperties": false, "properties": { "bien": { "description": "Id del bien (0x…) o su URL de alertasubastas.com.", "type": "string" }, "comentario": { "maxLength": 2048, "type": [ "string", "null" ] } }, "required": [ "bien", "comentario" ], "type": "object" }, "name": "comentar_favorita", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "bien": { "type": "string" }, "comentario": { "type": [ "string", "null" ] }, "creada": { "type": "string" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "estado": { "type": "string" }, "ficha": { "type": [ "object", "null" ] }, "message": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } }, { "description": "Plan, búsquedas, subastas consultadas y subastas finalizadas consultadas este mes con su cuota.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "consumo", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "bienes": { "type": "object" }, "busquedas": { "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "finalizadas": { "type": "object" }, "message": { "type": "string" }, "periodo": { "type": "string" }, "plan": { "type": "string" }, "rate_limit": { "type": "object" }, "suscripcion": { "type": "object" } }, "type": "object" } }, { "description": "Crea una alerta: los bienes nuevos que cumplan los filtros llegan por email. Aplica los límites del plan (número de alertas, altas al mes, alertas nacionales o por grupo de tipo de bien). Los filtros no se pueden editar después: para cambiarlos, borra y crea otra.", "inputSchema": { "additionalProperties": false, "properties": { "envio": { "description": "agrupado (por defecto), individual (no en alertas nacionales) o sin_email (solo avisos en la web).", "enum": [ "agrupado", "individual", "sin_email" ], "type": "string" }, "filtros": { "description": "Filtros de la alerta. Sin provincia la alerta es nacional (requiere un plan que lo incluya).", "properties": { "bienes_lote": { "description": "Bienes del lote: uno (lote de un solo bien) o varios.", "enum": [ "uno", "varios" ], "type": "string" }, "clase_subasta": { "description": "Origen de la subasta: 2 BOE judiciales, 3 notariales, 4 diputaciones, 5 ayuntamientos, 6 consejos comarcales, 7 Seguridad Social, 11 agencias tributarias autonómicas, 12 AEAT, 13 administraciones generales.", "type": "integer" }, "comarca": { "description": "Slug de comarca (\"maresme-barcelona\"), de la lista comarcas de listar_municipios. Excluyente con municipio.", "type": "string" }, "deposito": { "additionalProperties": false, "description": "Depósito requerido en euros: {min, max}.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "marca": { "description": "Marca del vehículo como slug (\"renault\", \"mercedes-benz\"); lista en opciones_filtros (marcas). Solo vehículos.", "type": "string" }, "municipio": { "description": "Nombre exacto del municipio, tal como lo devuelve listar_municipios.", "type": "string" }, "procedimiento": { "description": "Código de procedimiento (lista en opciones_filtros).", "type": "integer" }, "provincia": { "description": "Slug (\"a-coruna\") o nombre exacto (\"A Coruña\"). Lista en listar_provincias.", "type": "string" }, "reclamada": { "additionalProperties": false, "description": "Cantidad reclamada en euros: {min, max}, ambos incluidos. Es la del lote o, si no la hay, la de toda la subasta. Con el filtro quedan fuera los bienes sin cantidad reclamada.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "superficie": { "additionalProperties": false, "description": "Superficie en m² según catastro: {min, max} enteros, min incluido y max excluido. Construida; en solares y fincas rústicas, la de la parcela. Solo inmuebles; quedan fuera los bienes sin dato.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "texto_excluye": { "description": "Palabras que no debe contener el bien.", "maxLength": 255, "type": "string" }, "texto_incluye": { "description": "Palabras que debe contener el bien.", "maxLength": 255, "type": "string" }, "tipo_bien": { "description": "Obligatorio. Slug de opciones_filtros o un grupo: inmuebles, muebles, todos (los grupos requieren un plan que lo incluya).", "type": "string" }, "valoracion": { "additionalProperties": false, "description": "Valor de subasta en euros: {min, max}; basta uno de los dos.", "properties": { "max": { "type": "number" }, "min": { "type": "number" } }, "type": "object" }, "vivienda_habitual": { "description": "Si el inmueble es la vivienda habitual del deudor según el BOE.", "enum": [ "si", "no", "desconocido" ], "type": "string" } }, "required": [ "tipo_bien" ], "type": "object" }, "titulo": { "description": "Nombre de la alerta (opcional).", "type": "string" } }, "required": [ "filtros" ], "type": "object" }, "name": "crear_alerta", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "activa": { "type": "boolean" }, "creada": { "type": "string" }, "envio": { "type": "string" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "filtros": { "type": "object" }, "id": { "type": "string" }, "message": { "type": "string" }, "nacional": { "type": "boolean" }, "titulo": { "type": [ "string", "null" ] } }, "type": "object" } }, { "description": "Envía al equipo de AlertaSubastas una mejora que propone el usuario, un error que ha visto o un dato o una función que echa en falta; nos llega por email. Úsala solo cuando el usuario lo pida o acepte que la envíes, y enséñale antes el texto. Máximo 3 por hora y 10 al día. No consume cuota.", "inputSchema": { "additionalProperties": false, "properties": { "contexto": { "description": "Opcional: qué estaba haciendo (búsqueda, filtros, id del bien…), para entenderla.", "maxLength": 500, "type": "string" }, "texto": { "description": "Lo que quiere decirnos el usuario, con sus palabras.", "maxLength": 2000, "minLength": 3, "type": "string" }, "tipo": { "description": "mejora (propuesta), error (algo que no funciona o un dato equivocado) o falta_dato (un dato, filtro o función que no tenemos).", "enum": [ "mejora", "error", "falta_dato" ], "type": "string" } }, "required": [ "tipo", "texto" ], "type": "object" }, "name": "enviar_sugerencia", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "id": { "type": "integer" }, "message": { "type": "string" }, "ok": { "type": "boolean" } }, "type": "object" } }, { "description": "Cambia el estado de seguimiento de una favorita.", "inputSchema": { "additionalProperties": false, "properties": { "bien": { "description": "Id del bien (0x…) o su URL de alertasubastas.com.", "type": "string" }, "estado": { "enum": [ "nueva", "en_revision", "interesante", "preparando_puja", "pujando", "adjudicada", "finalizada", "descartada" ], "type": "string" } }, "required": [ "bien", "estado" ], "type": "object" }, "name": "estado_favorita", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "bien": { "type": "string" }, "comentario": { "type": [ "string", "null" ] }, "creada": { "type": "string" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "estado": { "type": "string" }, "ficha": { "type": [ "object", "null" ] }, "message": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } }, { "description": "Los 3 artículos de la ayuda de AlertaSubastas que mejor explican una duda sobre subastas públicas o sobre el servicio (depósito, cargas, cesión de remate, posesión, tipos de subasta, pujas, alertas, planes…), con su texto y su URL para citarla. Acepta la pregunta en lenguaje natural. No consume cuota y funciona sin cuenta.", "inputSchema": { "additionalProperties": false, "properties": { "q": { "description": "El concepto o la pregunta.", "maxLength": 200, "minLength": 2, "type": "string" } }, "required": [ "q" ], "type": "object" }, "name": "explicar_concepto", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "articulos": { "items": { "properties": { "id": { "type": "integer" }, "recurso": { "type": "string" }, "texto": { "type": "string" }, "titulo": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "type": "array" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "message": { "type": "string" }, "nota": { "type": "string" }, "q": { "type": "string" } }, "type": "object" } }, { "description": "Ficha de un bien en Markdown (bien, lote, subasta, documentos originales, valor de mercado), para la búsqueda profunda. Es la misma ficha que ver_bien: la primera consulta de cada bien consume 1 de la cuota mensual, repetirla es gratis. Abre solo las fichas necesarias; tras varias nuevas seguidas pide confirmación con el usuario (ver_bien con confirmado: true).", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "Id del bien (0x…), de search.", "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "fetch", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "id": { "type": "string" }, "message": { "type": "string" }, "metadata": { "type": "object" }, "text": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "type": "object" } }, { "description": "Alertas de la cuenta, con el límite del plan y las altas del mes.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "listar_alertas", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "alertas": { "items": { "properties": { "activa": { "type": "boolean" }, "creada": { "type": "string" }, "envio": { "type": "string" }, "filtros": { "type": "object" }, "id": { "type": "string" }, "nacional": { "type": "boolean" }, "titulo": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "altas_mes": { "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "limite": { "type": "integer" }, "message": { "type": "string" }, "usadas": { "type": "integer" } }, "type": "object" } }, { "description": "Favoritas de la cuenta, paginadas: id del bien, URL, comentario, estado de seguimiento (estado) y la ficha reducida del bien (ficha: resumen, ubicación sin número, importes redondeados, señales, estado de la subasta, plazo y consultada). El detalle, con ver_bien, que gasta 1 de la cuota por ficha nueva. Si el bien ya no está publicado, ficha y url son null. No consume cuota.", "inputSchema": { "additionalProperties": false, "properties": { "estado": { "description": "Estado de seguimiento de la favorita.", "enum": [ "nueva", "en_revision", "interesante", "preparando_puja", "pujando", "adjudicada", "finalizada", "descartada" ], "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "minimum": 0, "type": "integer" }, "subasta": { "description": "Solo las favoritas cuya subasta está en ese grupo, como las pestañas de Tus favoritas.", "enum": [ "activas", "proximas", "finalizadas" ], "type": "string" } }, "type": "object" }, "name": "listar_favoritas", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "favoritas": { "items": { "properties": { "bien": { "type": "string" }, "comentario": { "type": [ "string", "null" ] }, "creada": { "type": "string" }, "estado": { "type": "string" }, "ficha": { "type": [ "object", "null" ] }, "url": { "type": "string" } }, "type": "object" }, "type": "array" }, "limit": { "type": "integer" }, "message": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } }, "type": "object" } }, { "description": "Municipios con subastas de una provincia (el nombre es el valor exacto del filtro municipio) y sus comarcas (slug para el filtro comarca). Con q, busca un lugar escrito libremente (municipio, pedanía o comarca, admite erratas) entre todos los de la provincia y devuelve hasta 5 resultados; unica=1 si hay uno claro. No consume cuota.", "inputSchema": { "additionalProperties": false, "properties": { "provincia": { "description": "Slug o nombre de la provincia.", "type": "string" }, "q": { "description": "Lugar a buscar (por ejemplo \"Valldoreix\" o \"Sant Cugat\").", "type": "string" } }, "required": [ "provincia" ], "type": "object" }, "name": "listar_municipios", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "comarcas": { "type": "array" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "message": { "type": "string" }, "municipios": { "items": { "properties": { "nombre": { "type": "string" }, "slug": { "type": "string" } }, "type": "object" }, "type": "array" }, "provincia": { "type": "object" }, "resultados": { "type": "array" }, "unica": { "type": "integer" } }, "type": "object" } }, { "description": "Notificaciones de la cuenta: los bienes que encajaron con una alerta del usuario y se le enviaron por email. De cada una: id, id y URL del bien, alerta que la generó, fechas, si está revisada y la ficha reducida del bien (ficha: resumen, ubicación sin número, importes redondeados, señales, estado de la subasta, plazo y consultada). Para el detalle, ver_bien, que gasta 1 de la cuota mensual por ficha nueva: enseña la lista y pregunta al usuario qué fichas quiere abrir, no las abras en bloque. Si el bien ya no está publicado, url y ficha son null. total (con los filtros, sin contar revision) y pendientes son exactos; para seguir, page. Se pueden recorrer los primeros 10.000 resultados: si hay más, acota por fechas, alerta u otro filtro. No consume cuota. Requiere un plan con notificaciones.", "inputSchema": { "additionalProperties": false, "properties": { "alerta": { "description": "Solo las de esta alerta (id de listar_alertas).", "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" }, "clase_subasta": { "description": "Origen de la subasta: 2 BOE judiciales, 3 notariales, 4 diputaciones, 5 ayuntamientos, 6 consejos comarcales, 7 Seguridad Social, 11 agencias tributarias autonómicas, 12 AEAT, 13 administraciones generales.", "type": "integer" }, "desde": { "description": "Publicadas desde esta fecha (YYYY-MM-DD), incluida.", "type": "string" }, "hasta": { "description": "Publicadas hasta esta fecha (YYYY-MM-DD), incluida.", "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "municipio": { "description": "Nombre exacto del municipio, tal como lo devuelve listar_municipios. Necesita provincia.", "type": "string" }, "orden": { "description": "envio_desc (por defecto): la notificación más reciente primero. Los demás ordenan por la fecha de fin, la fecha de publicación de la subasta o el valor.", "enum": [ "envio_desc", "envio_asc", "fecha_celebracion_asc", "fecha_celebracion_desc", "fecha_insercion_desc", "fecha_insercion_asc", "valoracion_asc", "valoracion_desc" ], "type": "string" }, "page": { "minimum": 1, "type": "integer" }, "provincia": { "description": "Slug (\"a-coruna\") o nombre exacto (\"A Coruña\"). Lista en listar_provincias.", "type": "string" }, "revision": { "description": "Solo las pendientes de revisar o solo las revisadas. Sin el parámetro, todas.", "enum": [ "pendientes", "revisadas" ], "type": "string" }, "subasta": { "description": "Solo las notificaciones cuya subasta está en ese grupo.", "enum": [ "activas", "proximas", "finalizadas" ], "type": "string" }, "tipo_bien": { "description": "Slug del tipo de bien (vivienda, garaje, local-comercial, vehiculo…) o un grupo: inmuebles, muebles, todos. Lista en opciones_filtros.", "type": "string" } }, "type": "object" }, "name": "listar_notificaciones", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "limit": { "type": "integer" }, "message": { "type": "string" }, "notificaciones": { "items": { "properties": { "alerta": { "type": "string" }, "bien": { "type": "string" }, "enviada": { "type": "string" }, "fecha_revision": { "type": [ "string", "null" ] }, "ficha": { "type": [ "object", "null" ] }, "id": { "type": "string" }, "publicada": { "type": "string" }, "revisada": { "type": "boolean" }, "url": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "page": { "type": "integer" }, "pendientes": { "type": "integer" }, "total": { "type": "integer" } }, "type": "object" } }, { "description": "Provincias con su slug y nombre exacto, para los filtros. No consume cuota.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "listar_provincias", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "message": { "type": "string" }, "provincias": { "items": { "properties": { "nombre": { "type": "string" }, "slug": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, { "description": "Marca notificaciones como revisadas o como pendientes: por sus ids (los de listar_notificaciones, no los del bien; hasta 1.000) o todas las que cumplen unos filtros (hasta 5.000 por llamada; si quedan, repite la llamada). Úsala solo si el usuario lo pide. Por filtros, dile antes cuántas son (total o pendientes de listar_notificaciones con esos filtros) y que lo confirme. Pasar a pendiente borra la marca de apertura del email. Repetirla no cambia nada. No consume cuota.", "inputSchema": { "additionalProperties": false, "properties": { "estado": { "enum": [ "revisada", "pendiente" ], "type": "string" }, "filtros": { "additionalProperties": false, "description": "Los filtros de listar_notificaciones (sin revision, orden, limit ni page: el estado pedido decide cuáles cambian). {} son todas las notificaciones de la cuenta.", "properties": { "alerta": { "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" }, "clase_subasta": { "type": "integer" }, "desde": { "type": "string" }, "hasta": { "type": "string" }, "municipio": { "type": "string" }, "provincia": { "type": "string" }, "subasta": { "enum": [ "activas", "proximas", "finalizadas" ], "type": "string" }, "tipo_bien": { "type": "string" } }, "type": "object" }, "ids": { "description": "Ids de las notificaciones. O esto o filtros.", "items": { "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" }, "maxItems": 1000, "minItems": 1, "type": "array" } }, "required": [ "estado" ], "type": "object" }, "name": "marcar_notificaciones", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "cambiadas": { "type": "integer" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "estado": { "type": "string" }, "message": { "type": "string" }, "no_encontradas": { "items": { "type": "string" }, "type": "array" }, "quedan": { "type": "integer" }, "sin_cambio": { "type": "integer" } }, "type": "object" } }, { "description": "Plan de la cuenta, cupos del mes usados y disponibles (búsquedas, subastas consultadas, subastas finalizadas consultadas, alertas que se pueden crear y favoritas que se pueden guardar), rate limits y enlaces a precios y a la cuenta. Úsala antes de una tarea larga para saber cuánto queda. No consume cuota.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "mi_cuenta", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "alertas": { "type": "object" }, "busquedas": { "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "favoritas": { "type": "object" }, "message": { "type": "string" }, "periodo": { "type": "string" }, "plan": { "type": "object" }, "rate_limit": { "type": "object" }, "subastas_consultadas": { "type": "object" }, "subastas_finalizadas_consultadas": { "type": "object" }, "urls": { "type": "object" } }, "type": "object" } }, { "description": "Valores admitidos por los filtros (tipos de bien y sus grupos, clases de subasta, procedimientos, estados, pujas, vivienda habitual, bienes en el lote, marcas, órdenes) y los valores de la web para valor, depósito, superficie y cantidad reclamada: úsalos en los rangos, porque el servidor ajusta cualquier otro al valor de la lista más cercano hacia fuera. No consume cuota.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "opciones_filtros", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "clase_subasta": { "type": "array" }, "deposito": { "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "estado": { "type": "array" }, "message": { "type": "string" }, "orden": { "type": "array" }, "procedimiento": { "type": "array" }, "pujas": { "type": "array" }, "tipo_bien": { "type": "array" }, "valoracion": { "type": "object" } }, "type": "object" } }, { "description": "Deja de enviar los avisos de una alerta sin borrarla.", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "Id de la alerta.", "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "pausar_alerta", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "activa": { "type": "boolean" }, "creada": { "type": "string" }, "envio": { "type": "string" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "filtros": { "type": "object" }, "id": { "type": "string" }, "message": { "type": "string" }, "nacional": { "type": "boolean" }, "titulo": { "type": [ "string", "null" ] } }, "type": "object" } }, { "description": "Quita un bien de favoritas. No devuelve el hueco del límite mensual.", "inputSchema": { "additionalProperties": false, "properties": { "bien": { "description": "Id del bien (0x…) o su URL de alertasubastas.com.", "type": "string" } }, "required": [ "bien" ], "type": "object" }, "name": "quitar_favorita", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "message": { "type": "string" }, "ok": { "type": "boolean" } }, "type": "object" } }, { "description": "Vuelve a enviar los avisos de una alerta pausada (revalida los límites del plan).", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "Id de la alerta.", "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "reactivar_alerta", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "activa": { "type": "boolean" }, "creada": { "type": "string" }, "envio": { "type": "string" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "filtros": { "type": "object" }, "id": { "type": "string" }, "message": { "type": "string" }, "nacional": { "type": "boolean" }, "titulo": { "type": [ "string", "null" ] } }, "type": "object" } }, { "description": "Cambia el título de una alerta; vacío o null lo borra.", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "Id de la alerta.", "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" }, "titulo": { "type": [ "string", "null" ] } }, "required": [ "id", "titulo" ], "type": "object" }, "name": "renombrar_alerta", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "activa": { "type": "boolean" }, "creada": { "type": "string" }, "envio": { "type": "string" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "filtros": { "type": "object" }, "id": { "type": "string" }, "message": { "type": "string" }, "nacional": { "type": "boolean" }, "titulo": { "type": [ "string", "null" ] } }, "type": "object" } }, { "description": "Búsqueda de texto libre en subastas para la búsqueda profunda (deep research): devuelve hasta 10 resultados con id, título y URL. El título es la línea resumen de la ficha reducida (sin dirección exacta ni importes exactos). Para buscar con filtros (provincia, tipo, precio…) usa buscar_bienes. Consume 1 búsqueda de la cuota mensual (repetirla en 60 minutos es gratis). Sin cuenta, solo subastas finalizadas.", "inputSchema": { "additionalProperties": false, "properties": { "query": { "description": "Texto libre: tipo de bien, municipio, calle, referencia…", "maxLength": 200, "type": "string" } }, "required": [ "query" ], "type": "object" }, "name": "search", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "acceso": { "type": "string" }, "activas": { "type": "object" }, "consultadas": { "items": { "type": "string" }, "type": "array" }, "cuota_busquedas": { "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "message": { "type": "string" }, "results": { "items": { "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "type": "array" }, "total": { "type": "integer" } }, "type": "object" } }, { "description": "Una alerta de la cuenta.", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "Id de la alerta.", "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "ver_alerta", "outputSchema": { "properties": { "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "activa": { "type": "boolean" }, "creada": { "type": "string" }, "envio": { "type": "string" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "filtros": { "type": "object" }, "id": { "type": "string" }, "message": { "type": "string" }, "nacional": { "type": "boolean" }, "titulo": { "type": [ "string", "null" ] } }, "type": "object" } }, { "description": "Detalle completo de un bien: datos del bien, de su lote y de su subasta (valor, depósito, puja, cargas, situación posesoria, fechas, URL oficial…), los documentos originales (edicto, certificación de cargas, tasación…; el enlace abre la descarga en alertasubastas.com y pide sesión con plan o prueba), subastas similares (ids) y, si la hay, la estimación de valor de mercado (venta y alquiler, de Idealista). En zonas con poca actividad, Idealista no valora el inmueble y valor_mercado trae el precio medio de la zona por la superficie, con aproximado: true y sin rango. La primera consulta de cada bien consume 1 de la cuota mensual de subastas consultadas, repetirla es gratis. Ábrela solo para los bienes que el usuario quiere ver: para elegir, basta el resumen de buscar_bienes. Tras varias fichas nuevas seguidas pide confirmación (error confirmacion_necesaria): pregunta al usuario y, si lo confirma, repite con confirmado: true.", "inputSchema": { "additionalProperties": false, "properties": { "confirmado": { "description": "true solo si el usuario ha confirmado que quiere abrir más fichas tras un error confirmacion_necesaria.", "type": "boolean" }, "id": { "description": "Id del bien (0x…), de buscar_bienes, ver_lote o listar_favoritas.", "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "ver_bien", "outputSchema": { "properties": { "ID": { "type": "string" }, "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "bien": { "type": "object" }, "documentos": { "items": { "properties": { "etiqueta": { "type": "string" }, "tipo": { "type": "string" }, "titulo": { "type": [ "string", "null" ] }, "url": { "type": "string" } }, "type": "object" }, "type": "array" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "lote": { "type": "object" }, "message": { "type": "string" }, "resumen": { "type": "string" }, "similares": { "items": { "properties": { "distancia_km": { "type": [ "number", "null" ] }, "finalizada": { "type": "boolean" }, "id": { "type": "string" } }, "type": "object" }, "type": "array" }, "subasta": { "type": "object" }, "url": { "type": "string" }, "valor_mercado": { "type": [ "object", "null" ] } }, "type": "object" } }, { "description": "IDs de los bienes de un lote (se adjudican juntos) y la subasta a la que pertenece. No consume cuota.", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "lote.ID del detalle de un bien.", "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "ver_lote", "outputSchema": { "properties": { "BIENES": { "items": { "type": "string" }, "type": "array" }, "ID": { "type": "string" }, "SUBASTA_ID": { "type": "string" }, "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "message": { "type": "string" } }, "type": "object" } }, { "description": "IDs de los lotes de una subasta, en su orden. No consume cuota.", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "subasta.ID del detalle de un bien.", "pattern": "^0x[0-9A-Fa-f]{1,33}$", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "ver_subasta", "outputSchema": { "properties": { "ID": { "type": "string" }, "LOTES": { "items": { "type": "string" }, "type": "array" }, "_limites": { "description": "Cupos y rate limit restantes tras la llamada.", "type": "object" }, "error": { "description": "Código de error del API, si la llamada falla.", "type": "string" }, "message": { "type": "string" } }, "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:6a75002d0554671ed3d9f0099e39bde1927fab33bccdc2783ce2d96654548357 | sha256sum