Boletín Claro MCP Server

Lista tus clientes (modo clientes, para asesorías y gestorías) junto con las alertas que nutren a cada uno: esas alertas describen qué vigila cada cliente, así que son el contexto para decidir a qué cliente pertenece cada entrada del inbox. Úsala para '¿qué clientes tengo?' o antes de asignar entradas. Requiere tener el modo clientes activado.

Devuelve el inbox: las entradas que han encajado con tus alertas pero que aún no has archivado bajo ningún cliente. Es la primera criba de Boletín Claro; revísalas para decidir, con el contexto de cada cliente (listar_clientes), cuáles son relevantes y para quién. Cada entrada trae su 'id' para asignarla con asignar_entrada. Parámetros opcionales: 'limite' (por defecto 25, máximo 60) y 'alerta' (acota a una alerta por su nombre). Requiere tener el modo clientes activado.

Lista tus alertas temáticas y su estado: si están activas, su frecuencia de envío, los boletines que vigilan y si cada uno está al día o pendiente de procesar. Úsala para '¿qué alertas tengo?' o '¿están funcionando mis alertas?'.

Muestra las notas escritas en una entrada (lo anotado sobre esa oportunidad: gestiones hechas, plazos, pendientes), de la más reciente a la más antigua y con la fecha de vencimiento de cada una si la tiene. Indica 'entrada_id' (el 'id' de listar_entradas o mis_novedades) y, opcionalmente, 'cliente' para ver además las notas privadas de ese cliente. Cada nota trae su id, que es lo que necesita borrar_nota. Requiere iniciar sesión.

Busca en los boletines oficiales españoles (BOE, BORME y los boletines de las comunidades autónomas) cualquier cosa que NO sea una subvención ni una licitación: normativa, oposiciones, anuncios, nombramientos, edictos, etc. Para subvenciones o licitaciones usa buscar_oportunidades. Devuelve cada resultado con su boletín, fecha, lugar y enlace. No requiere iniciar sesión. Parámetros: 'tipos' (opcional, acota a códigos de boletín como BOE o BOJA) y 'limite' (1-25, por defecto 10).

Busca empresas por nombre (o parte del nombre) y devuelve sus NIF junto al total de dinero público recibido, para poder elegir una y consultar su detalle con perfil_empresa. Úsala cuando el usuario menciona una empresa por su nombre y no por su NIF. No requiere iniciar sesión.

Busca subvenciones y licitaciones públicas ABIERTAS que encajen con el perfil de una empresa o autónomo, descritas en lenguaje natural. Es la herramienta estrella para '¿qué ayudas o contratos hay para mí?'. Devuelve cada oportunidad con su importe, plazo, lugar y un enlace a la ficha de Boletín Claro. No requiere iniciar sesión. Parámetros: 'tipo' (subvenciones/licitaciones/ambos), 'zona' (CCAA, provincia o municipio) y 'limite' (1-20, por defecto 8). Para que el usuario reciba avisos automáticos de lo nuevo, dirígelo a crear una alerta en boletinclaro.es.

Borra una de tus alertas de forma PERMANENTE, junto con todo su histórico (avisos, notas y documentos). Indica el 'nombre' de la alerta tal como aparece en listar_mis_alertas. Es IRREVERSIBLE: llama primero con confirmar=false (por defecto) para avisar al usuario de qué se va a borrar, y solo con su visto bueno vuelve a llamar con confirmar=true. Si solo quiere dejar de recibir avisos sin perder el histórico, usa pausar_alerta en su lugar. Requiere iniciar sesión.

Borra una nota de una entrada. Indica 'nota_id' (el id que muestra listar_notas). El borrado es definitivo y solo puedes borrar las notas que escribiste tú; si la nota tenía fecha, deja de aparecer en el calendario y de generar avisos. Requiere iniciar sesión.

Crea una alerta para que Boletín Claro vigile el dinero público que te interesa y te avise por email cuando salga algo nuevo que encaje. Es el paso de la búsqueda puntual a la vigilancia continua. Toma una 'descripcion' en lenguaje natural (sector o actividad, zona e importes si aplican); no necesitas saber códigos. IMPORTANTE: llama primero con confirmar=false (por defecto) para mostrar al usuario un resumen de la alerta y pedir su visto bueno; solo cuando lo confirme, vuelve a llamar con confirmar=true para crearla. Requiere haber iniciado sesión.

Crea un nuevo cliente (empresa u organización) en tu modo clientes, para poder archivar entradas bajo él. Toma 'nombre' y opcionalmente 'descripcion' (quién es, sector, ubicación, qué busca): esa descripción es el contexto que se usará después para decidir qué entradas le interesan, así que merece la pena rellenarla. Si tu cuenta no tiene el modo clientes activado, te lo indicará y no lo creará. Requiere iniciar sesión.

Devuelve el detalle completo de UNA convocatoria de subvenciones (BDNS) a partir de su código (el que aparece en el enlace /subvencion que devuelve buscar_oportunidades): organismo, importe total, número de concesiones y beneficiarios, y principales beneficiarios. Úsala para resumir una subvención sin salir de Boletín Claro. No requiere iniciar sesión.

Devuelve el detalle completo de UNA licitación pública (PLACSP) a partir del 'id' de su enlace /licitacion (el que devuelve buscar_oportunidades), o de su nif_organo y expediente: importe, plazo, lugar de ejecución, tipo y procedimiento, CPV, lotes, órgano de contratación y adjudicatarios si ya está adjudicada. Úsala para resumir o comparar licitaciones sin abrir el portal oficial. No requiere iniciar sesión.

Edita una de tus alertas: cambia lo que vigila (con 'nueva_descripcion' en lenguaje natural) y/o su nombre (con 'nuevo_nombre'). Identifícala por su 'nombre' actual. Cambiar la descripción rehace el criterio de búsqueda, así que muéstrale primero al usuario el resumen (confirmar=false) y aplica el cambio solo con confirmar=true; renombrar no necesita confirmación. Requiere iniciar sesión.

Actualiza la DESCRIPCIÓN de un cliente del modo clientes: quién es, su sector, ubicación, qué busca y en qué estado está. Es el contexto con el que se decide qué entradas le interesan, así que mantenla al día: si al triar con el usuario aprendes algo nuevo de un cliente (ya no le interesa X, ahora busca Y, ha ganado tal contrato), propónle actualizarla y hazlo aquí. Toma 'cliente' (nombre tal como aparece en listar_clientes) y 'descripcion'. La nueva descripción SUSTITUYE a la anterior entera: parte de la existente y conserva lo que siga siendo válido. Muestra al usuario la nueva descripción antes de guardarla. Requiere tener el modo clientes activado.

Resume lo publicado en un boletín oficial un día concreto: '¿qué ha salido hoy en el BOE?' o '¿qué publicó el BOCM el lunes?'. Devuelve las entradas agrupadas por apartado o tipo (subvenciones, licitaciones, nombramientos, normativa…) con su número y una muestra de títulos, importes y plazos. Parámetros: 'fuente' (código del boletín: BOE, BOCM, BDNS, DOG, BOPV, BOJA…) y 'fecha' (AAAA-MM-DD; vacío = hoy). Es un índice del día; para el detalle de una entrada usa buscar_boletines. No requiere iniciar sesión.

Resume lo que ha encajado con tus alertas esta semana (de lunes a hoy), agrupado por alerta, usando los resúmenes que Boletín Claro ya generó. Úsala para 'resúmeme la semana' o '¿qué ha pasado en mis alertas estos días?'.

Escribe una nota en una de tus entradas: lo que hay que hacer, lo que ya se ha hecho o lo que conviene recordar sobre esa oportunidad. Indica 'entrada_id' (el 'id' que aparece en listar_entradas o mis_novedades) y 'nota'. Si añades 'fecha' (AAAA-MM-DD), la nota se convierte en un vencimiento del calendario y se avisa por email 7 días antes y el día antes: úsala para plazos de presentación, reuniones o recordatorios. Con 'cliente' (opcional, solo modo clientes) la nota queda bajo ese cliente en vez de a la vista de todo el espacio de trabajo. Es la misma nota que se ve en boletinclaro.es. Requiere iniciar sesión.

Archiva una entrada del inbox bajo uno o más clientes: es la segunda criba, la decisión de que esa oportunidad es relevante para ese cliente. Indica 'entrada_id' (el 'id' de listar_entradas) y 'clientes' (nombre o nombres separados por comas, tal como aparecen en listar_clientes). La entrada pasa al flujo de trabajo de cada cliente y la alerta que la detectó se vincula automáticamente al cliente. Requiere tener el modo clientes activado.

Quita una entrada del flujo de trabajo de uno o más clientes: es el inverso de asignar_entrada, para deshacer un archivado que no tocaba. Indica 'entrada_id' (el 'id' de la entrada) y 'clientes' (nombre o nombres separados por comas, tal como aparecen en listar_clientes). La entrada pierde el estado que tenía en el flujo de ese cliente; si ya no queda bajo ningún cliente, vuelve al inbox (listar_entradas). Desasignar una entrada que no estaba asignada a ese cliente no es un error. Requiere tener el modo clientes activado.

Descarta una o varias entradas del inbox que NO interesan a ningún cliente: es la acción de 'no me interesa, fuera del inbox', el complemento de asignar_entrada al terminar la criba. Indica 'entradas' (un id, o varios separados por comas, tal como aparecen en listar_entradas). No borra nada: la entrada queda marcada como descartada y puede recuperarse desde boletinclaro.es. Descartar una entrada ya descartada no es un error. Requiere tener el modo clientes activado.

Desvincula una de tus alertas de uno o más clientes del modo clientes: es el inverso de vincular_alerta, para cuando una alerta deja de describir lo que busca un cliente. Solo quita el vínculo (el contexto que muestra listar_clientes); no borra la alerta ni toca las entradas ya archivadas. Indica 'alerta' (nombre tal como aparece en listar_mis_alertas) y 'clientes' (nombre o nombres separados por comas, tal como aparecen en listar_clientes). Desvincular una alerta que no estaba vinculada no es un error. Requiere tener el modo clientes activado.

Devuelve las novedades recientes que han encajado con TUS alertas: las últimas oportunidades (subvenciones, licitaciones, anuncios) detectadas para tu espacio de trabajo, con su boletín, fecha, importe y plazo si los hay, y enlace. Úsala para '¿qué me ha llegado?' o '¿hay algo nuevo en mis alertas?'. Parámetros opcionales: 'dias' (ventana hacia atrás, por defecto 7) y 'limite' (máximo de resultados, por defecto 15).

Pausa una de tus alertas para dejar de recibir avisos sin borrarla. Indica el 'nombre' de la alerta tal como aparece en listar_mis_alertas. Reversible con reactivar_alerta. Requiere iniciar sesión.

Devuelve el perfil de dinero público de una empresa (por NIF), cruzando todas las fuentes: subvenciones recibidas (BDNS), licitaciones y contratos públicos GANADOS (PLACSP), proyectos de I+D europeos (CORDIS), contratos UE (TED) y datos mercantiles (BORME), con el total, el número de contratos/concesiones, el periodo y los principales organismos/sectores. Úsala para '¿qué licitaciones o contratos ha ganado X?', '¿qué subvenciones ha recibido X?', '¿cuánto dinero público recibió X?' o due diligence ('háblame de la empresa X'). Da agregados y un enlace a la ficha completa, no el listado contrato a contrato. Si solo tienes el nombre, usa antes buscar_empresa para obtener el NIF. No requiere iniciar sesión.

Reactiva una alerta que estaba pausada para volver a recibir avisos. Indica el 'nombre' de la alerta tal como aparece en listar_mis_alertas. Requiere iniciar sesión.

Crea una vigilancia de una o varias EMPRESAS concretas (competidores, clientes, proveedores) y avisa por email cuando tengan movimientos en el dinero público: contratos, subvenciones o cambios mercantiles. Para vigilar un TEMA (un sector o tipo de ayuda) usa crear_alerta; esta es para empresas con nombre y apellidos. Toma 'empresas' (nombres o NIFs separados por comas; por cada nombre se busca su NIF). IMPORTANTE: llama primero con confirmar=false (por defecto) para mostrar al usuario qué empresas se van a vigilar y pedir su visto bueno; solo cuando lo confirme, vuelve con confirmar=true. Es una función de pago. Requiere iniciar sesión.

Vincula una de tus alertas a uno o más clientes del modo clientes, para que cuente entre las alertas que los nutren (el contexto que muestra listar_clientes). Complementa el vínculo automático que hace asignar_entrada al archivar: úsala cuando una alerta recién creada deba colgar de un cliente sin esperar a su primera asignación. Indica 'alerta' (nombre tal como aparece en listar_mis_alertas) y 'clientes' (nombre o nombres separados por comas, tal como aparecen en listar_clientes). Vincular una alerta ya vinculada no es un error. Requiere tener el modo clientes activado.