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. Con más de 5 clientes la lista sale resumida; pasa 'cliente' para ver la ficha completa de uno. Requiere tener el modo clientes activado. Coste: 1 crédito del saldo compartido MCP/API.

Devuelve el inbox: las entradas que encajaron con tus alertas y aún no has archivado bajo ningún cliente (la primera criba). Decide con el contexto de listar_clientes cuáles interesan y a quién; cada una trae su 'id' para asignar_entrada. Filtros opcionales: 'alerta' (nombre), 'cliente_sugerido' (las alertas de ese cliente), 'veredicto' ('encaja' o 'posible'), 'desde' (AAAA-MM-DD), 'importe_minimo' e 'importe_maximo' (euros; dejan fuera lo que no tiene importe) y 'patron' (texto del título). 'detalle'='minimo' da una línea por entrada y admite hasta 200 por página; 'limite' fija la página (por defecto 25, máximo 60 en detalle completo). Si hay más, pasa el 'cursor' de la respuesta con los mismos filtros. Requiere el modo clientes. Coste: 1 crédito del saldo compartido MCP/API.

Lista tus alertas temáticas y su estado: si están activas, su frecuencia de envío, adónde llegan sus avisos, 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?'. Coste: 0 créditos de lectura.

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. Coste: 1 crédito del saldo compartido MCP/API.

Busca en los boletines oficiales (BOE, DOUE y los diarios oficiales autonómicos y forales) 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. Cubre solo los últimos ~180 días: lo publicado antes ya no está (salvo lo que sigue en plazo), así que no sirve para buscar convocatorias o normas de años anteriores. Disponible en todos los planes, también en Gratis. Parámetros: 'boletines' (opcional, acota a códigos de boletín como BOE o BOJA) y 'limite' (1-25, por defecto 10). Coste: 1 crédito del saldo compartido MCP/API.

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. Disponible en todos los planes, también en Gratis. Coste: 5 créditos del saldo compartido MCP/API.

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. Disponible en todos los planes, también en Gratis. 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. Coste: 1 crédito del saldo compartido MCP/API.

Borra una de tus alertas de forma PERMANENTE, junto con las entradas que no se hayan archivado (y sus notas y documentos); lo archivado bajo un cliente, con sus notas, se queda, igual que lo que también encontró otra alerta. 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. Coste: 0 créditos de lectura.

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. Coste: 0 créditos de lectura.

Crea una alerta para que Boletín Claro vigile los boletines oficiales y avise por email de lo nuevo que encaje: subvenciones, licitaciones, oposiciones, normativa o cualquier otro anuncio. Es el paso de la búsqueda puntual a la vigilancia continua. Toma una 'descripcion' en lenguaje natural (tema, sector o actividad, zona e importes si aplican), sin códigos. Las fuentes las propone el sistema por tema y zona y no lee exclusiones de la descripción: para fijarlas usa 'boletines' ('solo BOE y BDNS') y para quitar alguna, 'excluir_boletines' ('sin fondos europeos' → EUFUNDING, TED, DOUE). Los avisos van al email de quien la crea, salvo que 'destinos' diga otros (correos del equipo o de contacto, webhooks, Slack o Teams ya creados). Llama primero con confirmar=false para enseñar el resumen y crea con confirmar=true solo cuando el usuario lo confirme; la respuesta dice cómo ha quedado guardada (boletines, zona, importe, envío e id), que puede diferir del resumen. Coste: 0 créditos de lectura.

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. Coste: 0 créditos de lectura.

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. Disponible en todos los planes, también en Gratis. Coste: 5 créditos del saldo compartido MCP/API.

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. Disponible en todos los planes, también en Gratis. Coste: 5 créditos del saldo compartido MCP/API.

Edita una de tus alertas: cambia lo que vigila (con 'nueva_descripcion' en lenguaje natural), sus fuentes (con 'boletines' para fijarlas o 'excluir_boletines' para quitar alguna, por su código), adónde llegan sus avisos (con 'destinos') y/o su nombre (con 'nuevo_nombre'). Identifícala por su 'nombre' actual. Cambiar la descripción, las fuentes o los destinos se enseña antes y después: muéstraselo primero al usuario (confirmar=false) y aplica el cambio solo con confirmar=true; renombrar no necesita confirmación. Requiere iniciar sesión. Coste: 0 créditos de lectura.

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. Coste: 0 créditos de lectura.

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. Disponible en todos los planes, también en Gratis. Coste: 1 crédito del saldo compartido MCP/API.

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?'. Coste: 1 crédito del saldo compartido MCP/API.

Escribe una nota en una de tus entradas: lo que hay que hacer, lo hecho o lo que conviene recordar. Indica 'entrada_id' (de listar_entradas o mis_novedades) y 'nota'. Con 'fecha' (AAAA-MM-DD) sale en el calendario y se avisa por email antes; un plazo legal lo calcula expediente (accion plazo). Con 'cliente' (modo clientes) queda bajo ese cliente. Es la misma nota que se ve en boletinclaro.es. Requiere iniciar sesión. Coste: 0 créditos de lectura.

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. Coste: 0 créditos de lectura.

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. Coste: 0 créditos de lectura.

Descarta del inbox entradas que no interesan a ningún cliente; no borra nada (se recuperan en boletinclaro.es) y repetirlo no es un error. Indica 'entradas' (ids de listar_entradas, separados por comas) o, en bloque, los filtros de listar_entradas sin ids (p. ej. 'patron'='U.R. SUBASTAS'): confirmar=false muestra qué se descartaría y da un código; con el visto bueno del usuario, repite los filtros con confirmar=true y el código en 'confirmacion' (hasta 200 por llamada; si el inbox cambió, pide otra vista previa). Requiere el modo clientes. Coste: 0 créditos de lectura.

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. Coste: 0 créditos de lectura.

Prepara con el usuario una subvención o licitación en su expediente, que ve su equipo. Empieza con accion=abrir (estado, lo que falta, instrucciones). Acciones: pasos, guardar_documento (contenido, o donde si se queda en local), leer_documento (también PDF, Word e imágenes subidos), confirmar_documento, estado (cuando el usuario lo decida), plazo (fijo de la convocatoria, o legal que calcula Boletín Claro), importes, pasos_guardados, cliente (ficha, papeles, lo concedido y presentado; sin entrada_id) y datos_cliente (campos, prerrellenar, caducidad de un papel: su último día de vigencia, no la fecha de firma). Pedir documentos a un tercero (enlace y correo): pedir; lo que suba, revisar (documento_id y de). estado, pedir y plazo, con confirmar=false, solo enseñan lo que harán; escriben con confirmar=true. Ejemplos de datos: estado=presentada {registro, fecha: AAAA-MM-DD}; estado=descartada {motivo}; pedir {a: Gestoría López, correo, documentos: [Escrituras, …]}; plazo {texto, fecha_fija: AAAA-MM-DD, solicitud: true}; importes {solicitado, concedido, motivo}; datos_cliente {campo: valor}; prerrellenar {nif}. Notas: anotar_entrada. Coste: abrir, leer_documento y cliente 1 crédito; prerrellenar 5; el resto 0.

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). Coste: 1 crédito del saldo compartido MCP/API.

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. Coste: 0 créditos de lectura.

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. Disponible en todos los planes, también en Gratis. Coste: 5 créditos del saldo compartido MCP/API. Gratis: máximo cinco llamadas al mes por workspace, compartidas con /v1/empresas/{nif}.

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. Coste: 0 créditos de lectura.

Muestra UNA de tus entradas por su id: lo que ya ves en su página de boletinclaro.es. Devuelve título, boletín, fecha, importe, plazo, lugar y tipo de convocatoria o procedimiento; en qué punto está en tu flujo (en el inbox, archivada bajo qué cliente(s) y con qué estado, o descartada); la alerta que la detectó; sus fechas clave; el IDENTIFICADOR DE ORIGEN (código BDNS o expediente) con la herramienta que sigue desde él (detalle_convocatoria / detalle_licitacion); los datos de su ficha, el resumen generado si lo hay, los enlaces y sus notas. Indica 'entrada_id' (el 'id' de listar_entradas o mis_novedades, o el enlace /entradas/… entero) y, opcionalmente, 'cliente' para ver además las notas privadas de ese cliente. Funciona con entradas del inbox, archivadas o descartadas. Requiere iniciar sesión. Coste: 1 crédito del saldo compartido MCP/API.

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. Coste: 5 créditos por cada nombre que haya que resolver a NIF; 0 si se envían NIF. Se mantienen los límites y confirmaciones del plan.

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. Coste: 0 créditos de lectura.