Herramientas MCP

Informa de los cambios recientes en todos los proyectos accesibles del usuario autenticado; es la herramienta que un agente consulta para clasificar errores recién creados. Devuelve tres secciones compactas dentro de una ventana temporal: tareas CREATED nuevas, tareas UPDATED recientemente creadas antes de la ventana y COMMENTS recientes de tareas. Se limita a proyectos de los que el usuario es owner o member.

Busca tareas por palabra clave en todos los proyectos a los que pertenece el usuario autenticado. Busca en nombres y descripciones de tareas. Devuelve hasta 20 resultados con contexto de proyecto e información de prioridad.

Verifica la conectividad con el servidor MCP de Taskavel. Devuelve una respuesta pong que confirma la conexión junto con la dirección de correo electrónico del usuario autenticado.

Recupera tareas con fechas límite próximas dentro del número de días especificado, 7 por defecto, incluidas las tareas vencidas. Los resultados se limitan a los proyectos a los que pertenece el usuario autenticado.

Herramienta de consulta central para agentes que deciden en qué trabajar. Filtra las tareas accesibles del usuario autenticado por proyecto, columna de tablero, etiqueta, responsable, estado, ventanas de creación o fecha límite y prioridad, con ordenación configurable. Usa created_after para mostrar trabajo creado recientemente. Devuelve una lista compacta lista para decidir. Cada consulta se limita a proyectos de los que el usuario es owner o member.

Recupera todos los tableros y sus columnas para un proyecto especificado. Requiere pertenencia al proyecto. Proporciona el nombre del proyecto o una palabra clave para localizarlo.

Enumera hitos de un proyecto con información de progreso. Muestra nombre, fechas, recuento de tareas y porcentaje de finalización de cada hito. Úsalo para encontrar hitos existentes antes de crear otros o asignar tareas. Si no se especifica proyecto, enumera hitos de todos los proyectos accesibles.

Recupera las tareas asignadas al usuario autenticado. Devuelve nombres de tareas, fechas límite, prioridades, columnas de tablero, estado de finalización y enlaces directos a cada tarea.

Recupera todos los proyectos de los que el usuario autenticado es miembro. Devuelve nombres de proyecto, roles de usuario (owner, admin, member o guest), número de miembros y tipo de plan del propietario del proyecto.

Enumera todos los tableros de un proyecto, incluido el id de cada tablero, el recuento de columnas y el recuento de tareas. Requiere pertenencia al proyecto. Úsalo para descubrir tableros antes de crear tareas o un tablero nuevo. Proporciona el nombre del proyecto o una palabra clave para localizarlo.

Recupera detalles completos de una tarea específica, incluida la descripción, responsables, listas de tareas, subtareas, dependencias y comentarios recientes. Las tareas pueden localizarse por ID o buscando su nombre y descripción.

Recupera tareas completadas hoy, o en una fecha específica, en todos los proyectos donde el usuario es owner o member. Muestra quién completó cada tarea y cuándo. Es útil para standups diarios, informes de progreso y actualizaciones de equipo.

Recupera las tareas actualmente en progreso de un compañero específico. Busca usuarios por nombre en todos los proyectos compartidos. Si varios usuarios coinciden con el nombre, devuelve una lista con correos electrónicos para aclaración. Solo muestra tareas de columnas marcadas como tipo "in progress" o "progressing". Devuelve nombres de tareas, prioridades, columnas de tablero y enlaces directos.

Devuelve la tarea en la que el usuario autenticado tiene actualmente un temporizador activo, incluido nombre de tarea, número #, started_at y tiempo transcurrido, o un mensaje claro de que no hay temporizador en ejecución. Llámala antes de StartStopTimetrackTool cuando necesites conocer el estado actual en lugar de adivinar desde una alternancia.

Devuelve una vista compacta de todo el tablero en una llamada para que un agente pueda razonar sobre el estado sin muchos viajes de ida y vuelta. Enumera cada columna en orden con su tipo, recuento de tareas y hasta 5 tareas abiertas, y termina con totales de abiertas frente a completadas. Se limita a un proyecto del que el usuario autenticado es owner o member.

Recupera el informe de standup diario del usuario autenticado correspondiente a hoy, incluidas todas las tareas asociadas y sus comentarios. Devuelve el standup formateado como markdown.

Actualiza un hito existente. Puede cambiar nombre, descripción, fechas y color. Resuélvelo mediante milestone_id o busca por nombre dentro de un proyecto. Requiere rol owner, admin o member.

Actualiza una tarea existente. Admite renombrarla, cambiar su descripción, modificar fechas límite y marcarla como completada o incompleta. La finalización se valida frente a subtareas, elementos de todo y dependencias bloqueantes incompletos. Requiere rol owner, admin o member.

Activa o desactiva que el usuario que llama esté observando una tarea, es decir, suscrito a sus notificaciones. Cualquier miembro del proyecto puede observar una tarea.

Añade un comentario a una tarea. Requiere el rol owner, admin o member en el proyecto. Los usuarios guest no pueden comentar.

Asigna o elimina tareas de un hito. Acciones: "assign" establece el hito en tareas y "remove" borra el hito. Puede operar sobre una tarea o varias a la vez. Si el hito no existe, sugiere crearlo. Requiere rol owner, admin o member.

Asigna, reemplaza o elimina responsables de una tarea. Las acciones "assign" añaden un usuario sin quitar responsables existentes, "replace" convierte al usuario seleccionado en el único responsable y "remove" elimina la asignación del usuario seleccionado. El usuario objetivo debe pertenecer al proyecto de la tarea y el usuario que actúa debe tener rol owner, admin o member.

Crea una etiqueta nueva en un proyecto. Las etiquetas tienen nombre, color opcional y descripción opcional. Requiere rol owner, admin o member.

Crea un hito nuevo en un proyecto. Los hitos agrupan tareas relacionadas y siguen el progreso hacia un objetivo. Proporciona como mínimo el proyecto y el nombre del hito. Requiere rol owner, admin o member.

Crea un proyecto completo en una llamada. Pasa solo un nombre para un proyecto con tablero predeterminado, o una estructura completa diseñada por ti, con columnas, hitos y tareas. El agente que llama es aquí el generador; esta herramienta solo persiste la estructura y NO ejecuta el pipeline de generación de IA asíncrona de pago. El creador se convierte en owner del proyecto.

Crea un tablero nuevo en un proyecto, opcionalmente inicializado desde una plantilla. Requiere rol owner, admin o member. Los usuarios guest no pueden crear tableros. Proporciona como mínimo el nombre del proyecto y el nombre del tablero.

Crea una tarea nueva en un proyecto. Requiere el rol owner, admin o member. Proporciona como mínimo el nombre del proyecto y el nombre de la tarea.

Establece o borra la prioridad de una tarea. Usa priority_name, por ejemplo "High Priority", "Medium Priority" o "Low Priority", o priority_id para establecerla, o clear=true para eliminar la prioridad. Requiere rol owner, admin o member.

Duplica una tarea, incluidas sus listas de comprobación, etiquetas y responsables. La tarea nueva se llama "(duplicated) <original name>" y pertenece al usuario que llama. Requiere rol owner, admin o member.

Gestiona dependencias entre dos tareas. La acción "add", predeterminada, vincula task_id y related_task_id de forma recíproca: un vínculo "blocked_by" en task_id crea un vínculo "blocks" correspondiente en related_task_id, y viceversa. La acción "remove" separa el vínculo en ambos sentidos. Requiere rol owner, admin o member.

Gestiona etiquetas de una tarea. Acciones: "add" adjunta etiquetas sin eliminar las existentes, "remove" separa etiquetas específicas y "set" sustituye todas las etiquetas. Proporciona tag_names o tag_ids. Requiere rol owner, admin o member.

Gestiona listas de comprobación, listas todo, de una tarea y sus elementos. Una lista agrupa elementos ligeros marcables. Usa action=create_checklist para añadir una lista, add_item para anexar un elemento, toggle_item para cambiar un elemento entre completado e incompleto y list para leer todas las listas con progreso. Requiere rol owner, admin o member.

Gestiona recordatorios de una tarea. Usa action=add para programar un recordatorio, list para leer los recordatorios de una tarea o remove para eliminar uno por id. Requiere rol owner, admin o member.

Gestiona el informe de standup diario del usuario autenticado. Añade tareas al standup de hoy, establece comentarios por tarea o establece un resumen. Crea el standup de hoy si todavía no existe.

Gestiona subtareas de una tarea principal. Una subtarea es una tarea vinculada a su principal. Usa action=create para añadir una subtarea, opcionalmente con fecha límite, o action=list para leer las subtareas de la principal. Requiere rol owner, admin o member.

Inicia o detiene el seguimiento de tiempo de una tarea. Pasa `action: "stop"` para detener explícitamente: es una operación segura sin efecto que nunca inicia un temporizador si esta tarea no tiene uno en ejecución. Pasa `action: "start"` para iniciar explícitamente: es una operación segura sin efecto si el temporizador de esta tarea ya se está ejecutando. Iniciar un temporizador siempre detiene primero el temporizador activo de cualquier otra tarea de este usuario; solo puede ejecutarse uno a la vez y la respuesta nombra esa otra tarea. Omite `action` para el comportamiento heredado de alternancia: detiene el temporizador si el de esta tarea está activo y, de otro modo, inicia uno tras detener cualquier otro. Usa GetRunningTimerTool primero si necesitas conocer el estado actual antes de decidir. Requiere rol owner, admin o member.

Invita a un usuario a un proyecto por correo electrónico. Solo los propietarios y administradores del proyecto pueden invitar miembros. Se aplican los límites del plan gratuito, con un máximo de 5 miembros. Envía un correo de invitación a la dirección especificada.

Mueve una tarea a otra columna del tablero. Resulta útil para cambiar el estado, por ejemplo de "To Do" a "In Progress" o "Done". Requiere rol owner, admin o member.

Mueve varias tareas a la vez a una columna de destino. Filtra tareas por nombre de compañero, hito o columna actual. Como admin u owner puedes mover tareas de cualquier miembro del equipo. Si no se encuentra la columna de destino, lista las columnas disponibles para que el usuario elija. Requiere rol owner o admin.

IMPORTANTE: usa ESTA herramienta cuando el usuario quiera responder a un comentario. comment_id es el número que se muestra como #xxx en la interfaz de Taskavel. Ejemplo: el usuario dice "reply to comment #1276" → usa esta herramienta con comment_id=1276. Admite mencionar usuarios por nombre o correo electrónico.

Sube un archivo adjunto, como una captura de pantalla, registro o PDF, a una tarea. Envía los bytes sin procesar codificados en base64 en file_base64 junto con file_name, que debe incluir la extensión, por ejemplo "screenshot.png". Se acepta y elimina un prefijo URI de datos como "data:image/png;base64,...". Máximo 10 MB por archivo después de descodificar; también cuenta contra la cuota de almacenamiento del propietario del proyecto. Extensiones permitidas: imágenes (jpg, jpeg, png, gif, webp, heic, svg), vídeo (mp4, mov, webm, ...), audio (mp3, wav, ogg), documentos (pdf, txt, md, rtf, doc, docx, xls, xlsx, ppt, pptx) y archivos (zip, rar, tar, gz). Úsalo para adjuntar evidencia a una tarea. Requiere rol owner, admin o member; guest no puede subir archivos.

Archiva una tarea, la elimina de forma reversible. La tarea se oculta de los tableros pero puede restaurarse más tarde; no se elimina permanentemente. Requiere rol owner, admin o member.

Elimina permanentemente una etiqueta de un proyecto y la desvincula de todas las tareas. Requiere rol owner, admin o member. Usa tag_id o tag_name para identificar la etiqueta.

Elimina un hito de un proyecto. Las tareas asignadas a este hito se desvinculan pero NO se eliminan. Requiere rol owner o admin. Pide confirmación al usuario antes de eliminarlo.

Elimina un miembro de un proyecto. Solo los propietarios y administradores del proyecto pueden eliminar miembros. El propietario del proyecto no puede eliminarse.

Elimina permanentemente una tarea YA ARCHIVADA. Es irreversible. Refleja el flujo de la aplicación papelera y vaciar papelera: primero debe archivarse una tarea con ArchiveTaskTool y después puede purgarse del archivo aquí. Las tareas activas no pueden eliminarse permanentemente en un paso. Requiere confirm:true y rol owner, admin o member.