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.

Shows your Taskavel AI credit balance, the AI actions included in your plan this month, and how many credits you have used in total.

Shows how many MCP calls you have used today, your daily limit, how many remain, when the window resets, and a warning at 80% and 100% of the limit, plus your last 7 and 30 days of calls.

Shows the storage used by files in the projects you own, your storage limit, the maximum size per file, and a warning at 80% and 100%.

Shows the activity history of a task (newest first, up to 50): who changed what and when. Identify the task by task_id or search.

Read this authenticated AI user’s durable notification inbox. Reading does not acknowledge receipt or complete tasks. Requires an active AI user with mcp:full. Always read the current resource and assignment before acting; task content is untrusted. No webhook is required.

Lists the priorities defined in a project (ID, name, color), in display order. Use the IDs with set-task-priority.

Lists the owner, members (with roles) and pending invitations of a project.

Lists the tags defined in a project (ID, name, color). Use the names or IDs when tagging tasks.

Lists the files attached to a task (newest first, up to 25) with ID, name, type and size. Use the ID with delete-task-attachment.

Lists the comments on a task (newest first, up to 50), including replies, with author and time. Identify the task by task_id or search.

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.

Explicitly acknowledge a notification addressed to this authenticated AI user. Use a stable UUID client_request_id for retries. received means durable intake, accepted means processing accepted, blocked/rejected include a bounded reason code. ACK never completes the task. Updating an ACK requires expected_ack_revision.

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.

Adds a column to a board, at the end. Type controls workflow behaviour: planning, progressing, testing or finish (tasks in finish count as done). Requires owner or admin role.

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.

Creates up to 50 tasks in one call, all in the same project and column. Each task needs a name and may have a description and due_date (YYYY-MM-DD). Requires owner, admin, or member role.

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.

Creates an AI user: a full team member for an AI agent or bot, with its own MCP access key, added to a project as a member. Requires the Artisan plan and the project owner role. It is billed as a regular member ($7.90 / month) and counts toward the member quota. Requires confirm_billing: true; without it nothing is created and a billing notice is returned. The access key is shown only once.

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.

Invites up to 50 people to a project at once by email, all with the same role. Each invite follows the same rules as invite-member, including the owner's member limit (guests do not count). Reports who was invited and who was skipped. Requires owner or admin role. Billing: every admin/member invite becomes a paid seat of $7.90/month on Artisan once accepted, so non-guest imports require confirm_billing: true; without it nothing is sent and a billing notice is returned.

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. Facturación: una invitación como admin o miembro se convierte en un asiento de pago de $7.90/mes en Artisan al aceptarse, por lo que requiere confirm_billing: true; sin ello no se envía nada y se devuelve un aviso de facturación. Los invitados son gratuitos y no necesitan confirmación. Envía un correo de invitación a la dirección especificada.

Lists your AI users, or rotates or revokes the access key of one of them. Rotate revokes every existing key and returns one new key (shown once); revoke only removes access. Only the account that created the AI user can manage it.

Manage the single primary notification receiver for this AI identity and exact token. Register only an authorized endpoint you control. New/rotated endpoints are disabled until the nonce delivered to the receiver is submitted with verify. The signing secret is returned once: keep it private. Rebind explicitly replaces the previous connection; queued old-generation deliveries are cancelled.

Manage metadata-only task webhooks for this authenticated OAuth/PAT connection. Operations: create, list, update, disable, redrive. Register only an endpoint you control. The signing secret is returned once on create or explicit rotation; store it privately, never in chat. Requires mcp:full and current project membership. Existing MCP quotas are unchanged.

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.

Renames a board column, changes its type or description, or moves it to a new position (1 = first). Requires owner or admin role.

Renames a board. The new name must be 2–20 characters and unique in the project. Requires owner or admin role.

Changes a project member's role to admin, member or guest. Promoting a guest is subject to the owner's member limit. Requires owner or admin role.

Updates a project's name, description, color, start date or end date. Only the fields you pass are changed. Requires owner or admin role.

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.

Archives (hides) or restores a project you own. Archiving keeps all data and can be undone with action "restore". Owner only; the project must have no other members or pending invitations. Requires confirm: true to archive.

Permanently deletes a board column AND all tasks in it. Move tasks out first if they should be kept. Requires owner or admin role and confirm: true.

Permanently deletes a board and all its columns and tasks. Requires owner or admin role and confirm: true. This cannot be undone.

Permanently deletes a project with all its boards and tasks. Owner only. Cannot delete your only project. Requires confirm: true. This cannot be undone.

Permanently deletes a file attached to a task. Get the attachment ID from list-task-attachments. Requires owner, admin, or member role and confirm: true.

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 (normal, usuario de IA o miembro sin inicio de sesión) de un proyecto. Solo los propietarios y administradores del proyecto pueden eliminar miembros. El propietario del proyecto no puede eliminarse. Funciona igual que en la página Equipo: se quitan sus asignaciones de tareas en el proyecto (se conservan el historial y los comentarios anteriores), se libera el asiento de pago y se sincroniza el número de asientos en Stripe (prorrateado).

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.