MCP tool catalog.
87 tools at https://app.agent-task.com/v1/public/mcp. Each needs one scope on your API key or OAuth consent; read-only tools never change anything. Connect a client first in the MCP setup guide.
Tasks, search & workflow
| Tool | Scope | Access | Arguments |
|---|---|---|---|
list_tasks_and_subtasksList Tasks & Subtasks List tasks AND their subtasks, filtered by space, status, assignee ("me", a user UUID, or a username), project, and/or group. | tasks:read | Read-only | spaceUuid?, status?, assignee?, projectUuid?, groupUuid?, type?, labels?, priority?, isBlocked?, dueAfter?, dueBefore?, overdue?, dueWithinDays?, createdAfter?, createdBefore?, updatedAfter?, updatedBefore?, staleAfterDays?, createdBy?, hasAttachment?, includeArchived?, sortBy?, sortOrder?, limit?, cursor? |
update_taskUpdate Task Update any subset of a task’s fields (status, priority, title, description, assignee, reviewer, labels, group, project, dueDate, prUrl, isBlocked) in one call. | tasks:write | Writes | taskUuid?, spaceUuid?, status?, priority?, title?, description?, assignee?, assignees?, reviewer?, labels?, groupUuid?, projectUuid?, dueDate?, prUrl?, isBlocked?, sessionId?, sessionName?, branch?, worktreePath?, hostname?, os?, client?, items? |
create_taskCreate Task Create a top-level task in a space. | tasks:write | Writes idempotencyKey | spaceUuid?, title?, description?, status?, priority?, groupUuid?, projectUuid?, assignee?, assignees?, reviewer?, labels?, proposedGroupName?, proposedGroupDescription?, idempotencyKey?, items? |
create_subtaskCreate Subtask Create a subtask under a parent task (a step of the parent, not a separate ticket); use create_task for standalone work. | subtasks:write | Writes idempotencyKey | spaceUuid, parentTaskId, title; description?, assignees?, labels?, idempotencyKey?, sessionId?, sessionName?, branch?, worktreePath?, hostname?, os?, client? |
get_agent_contextGet Agent Context Diagnose YOUR OWN run: the agent-context report for the calling organization. | tasks:read | Read-only | surface? |
fetchFetch Entity Fetch any entity (task, subtask, project, note, task group, note group, or crew) by its app URL, UUID, or code (e.g. AI-32, AI-N27, AI-P4, AI-CR2). | tasks:read | Read-only | ref; type? |
searchSearch Workspace Full-text search across tasks, subtasks, projects, notes, task comments, task groups, and labels. | tasks:read | Read-only | query; type?, spaceUuid?, space?, mentions?, limit?, cursor? |
list_subtasksList Subtasks List the subtasks of a task. | subtasks:read | Read-only | taskUuid?, spaceUuid?, limit?, cursor? |
update_subtaskUpdate Subtask Update any subset of a subtask’s fields (title, description, status, assignee, labels). spaceUuid is optional (inferred from the subtask). | subtasks:write | Writes | subtaskUuid; spaceUuid?, title?, description?, status?, assignee?, assignees?, labels?, sessionId?, sessionName?, branch?, worktreePath?, hostname?, os?, client? |
start_workStart Work Begin a unit of work and get the ticket to work on. | tasks:write | Writes | spaceUuid?, title?, sessionId?, sessionName?, worktreePath?, branch?, hostname?, os?, client?, model? |
suggest_groupSuggest Group Decide where a new task belongs in a space, from groups' learned memory. | tasks:read | Read-only | spaceUuid, title; description?, newAreaOfWork?, proposedGroupName?, proposedGroupDescription?, proposedSpaceName?, proposedSpaceDescription? |
link_entitiesLink Entities Link two entities (task ↔ project ↔ note, any pair) so each shows in the other's links. | tasks:write | Writes | source, target; sourceType?, targetType?, role? |
unlink_entitiesUnlink Entities Remove the link between two entities (task/project/note, by UUID or app URL). | tasks:write | Writes | source, target; sourceType?, targetType? |
list_favoritesList Favorites List your favorites (personal pins) across tasks, task groups, projects, notes, and clients. Only listed when its feature is enabled | tasks:read | Read-only | entityType?, limit?, cursor? |
get_plan_guideGet Plan Guide The product plan catalog, projected from the entitlements SSOT — answers "which plan does what": limits, features, pricing, and upgrade edges per plan. | tasks:read | Read-only | plan?, compare? |
get_workspace_planGet Workspace Plan What plan is this workspace on, what's near its limits, and what would an upgrade change — the calling org's effective entitlements, subscription state, per-dimension usage, and upgrade hints. | tasks:read | Read-only | — |
Agent runs & profiles
| Tool | Scope | Access | Arguments |
|---|---|---|---|
list_machinesList Machines List the fleet machines you can route agent work to: org-shared machines plus your own private ones (colleagues’ private machines are not shown). Only while agent runs are enabled for the workspace | tasks:read | Read-only | spaceUuid? |
configure_project_agentConfigure Project Agent Configure a project for agent execution: machine pin (machineUuid; null unpins), executor, dispatchMode, routingMode, workspaceMode, autonomy, maxConcurrency, YOUR localRepoPath, and the agentEnabled switch. Only while agent runs are enabled for the workspace | projects:write | Writes | projectUuid; expectedRevision?, machineUuid?, agentEnabled?, executor?, dispatchMode?, autonomy?, routingMode?, workspaceMode?, localRepoPath?, maxConcurrency?, op?, profileUuid?, expectedProfileRevision?, dryRun?, confirmPublication? |
launch_taskLaunch Task Hand an existing task to the fleet. Only while agent runs are enabled for the workspace | tasks:write | Writes idempotencyKey | taskUuid?, machineUuid?, baseRef?, dryRun?, steer?, follow?, idempotencyKey?, items? |
cancel_runCancel Run Cancel the ACTIVE fleet run on a task (claim in claimed/in_progress/blocked), addressed by taskUuid or claimUuid. Only while agent runs are enabled for the workspace | tasks:write | Writes idempotencyKey | taskUuid?, claimUuid?, idempotencyKey? |
list_runsList Runs List fleet agent runs (newest first), one record per execution a machine took on a task. Only while agent runs are enabled for the workspace | tasks:read | Read-only | projectUuid?, taskUuid?, machineUuid?, executor?, outcome?, executionKind?, startedAfter?, startedBefore?, limit?, cursor? |
get_runGet Run Get one run in full by runUuid (from list_runs): outcome + outcomeLine (judge delivery by outcomeLine), exit code, summary, executor/model (null = never reported), machine, timing, cost/tokens/turns, branch/PR, workspace, and the LAST ~8… Only while agent runs are enabled for the workspace | tasks:read | Read-only | runUuid; logTailLines?, includeSteps?, stepsLimit? |
publish_run_resultPublish Run Result Resume the DELIVERY stage a finished run did not complete — never a re-run of the task, never a merge, never a deploy. Only while agent runs are enabled for the workspace | tasks:write | Writes idempotencyKey | runUuid; destinationRepoUrl?, targetBranch?, expectedResultSha?, stage?, dryRun?, idempotencyKey? |
export_run_artifactsExport Run Artifacts Reconcile a run’s DECLARED outputs against the task’s attachments, deduplicating on sha256 checksum. Only while agent runs are enabled for the workspace | tasks:write | Writes | runUuid; names?, dryRun? |
recover_run_workspaceRecover Run Workspace Authorize the recovery of a retained run result into a fresh helper-owned worktree on a machine you name, and return the verified plan (repo, result ref, sha, commands). Only while agent runs are enabled for the workspace | tasks:write | Writes | runUuid, machineUuid; dryRun? |
preview_run_cleanupPreview Run Cleanup Say what cleanup WOULD do to a run’s workspace and helper-owned storage — and delete nothing (`deletes: false` is part of every answer; executing a cleanup is deliberately not reachable from this tool, or from any read). Only while agent runs are enabled for the workspace | tasks:read | Read-only | runUuid |
schedule_fleet_runSchedule Fleet Run Create a recurring or one-shot schedule that launches agent work. Only while agent runs are enabled for the workspace | tasks:write | Writes | spaceUuid, name, projectUuid, titleTemplate, scheduleKind; descriptionTemplate?, taskGroupUuid?, priority?, machineUuid?, at?, everyMinutes?, cron?, timezone?, overlapPolicy?, profileSelection?, profileVersion? |
list_fleet_schedulesList Fleet Schedules List the fleet-launch schedules in a space with their next/last fire, whether they are enabled, why the scheduler disabled one (disabledReason), how many consecutive runs have been skipped or have failed, and the last few runs. Only while agent runs are enabled for the workspace | tasks:read | Read-only | spaceUuid |
cancel_fleet_scheduleCancel Fleet Schedule Delete a fleet-launch schedule so it stops firing. Only while agent runs are enabled for the workspace | tasks:write | Writes | spaceUuid, scheduleUuid |
list_profilesList Agent Profiles List a space’s agent profiles — the reusable per-repository agent configuration projects attach to: repo, base branch, modes, executor, model, current version/digest/revision, attached-project count, last run and default machine. Only while agent runs are enabled for the workspace | projects:read | Read-only | spaceUuid; includeArchived?, limit?, cursor? |
get_profileGet Agent Profile Read one agent profile: the current (or a historical `version`) policy — where work runs, how it runs and how the result is handed off. Only while agent runs are enabled for the workspace | projects:read | Read-only | profileUuid; version? |
create_profileCreate Agent Profile Create an agent profile in a space (organization ADMINS only). Only while agent runs are enabled for the workspace | projects:write | Writes idempotencyKey | spaceUuid, name, repoUrl; description?, workKind?, baseBranch?, repoSubdir?, workspaceMode?, routingMode?, dispatchMode?, defaultNodeUuid?, executor?, model?, mcpConnectorIds?, notifyLevel?, autonomy?, maxConcurrency?, lockedKeys?, deliveryMode?, destinationRepoUrl?, targetReviewBranch?, requiredOutputs?, verificationExpectation?, retentionPruneAfterDays?, retentionRequireAck?, publicationAuthority?, publicationDestinations?, keepWorktreesWarm?, bootstrapCommand?, bootstrapTimeoutSeconds?, toolPermissions?, dryRun?, idempotencyKey? |
update_profileUpdate Agent Profile Change an agent profile (organization ADMINS only). Only while agent runs are enabled for the workspace | projects:write | Writes idempotencyKey | profileUuid; expectedRevision?, name?, description?, workKind?, repoUrl?, baseBranch?, repoSubdir?, workspaceMode?, routingMode?, dispatchMode?, defaultNodeUuid?, executor?, model?, mcpConnectorIds?, notifyLevel?, autonomy?, maxConcurrency?, lockedKeys?, deliveryMode?, destinationRepoUrl?, targetReviewBranch?, requiredOutputs?, verificationExpectation?, retentionPruneAfterDays?, retentionRequireAck?, publicationAuthority?, publicationDestinations?, keepWorktreesWarm?, bootstrapCommand?, bootstrapTimeoutSeconds?, toolPermissions?, dryRun?, idempotencyKey? |
set_my_profile_prefsSet My Profile Preferences Set YOUR personal layer on an agent profile — any member, for themselves only (the shared profile stays admin-only). preferredNodeUuid: your preferred machine… Only while agent runs are enabled for the workspace | projects:write | Writes idempotencyKey | profileUuid; preferredNodeUuid?, checkout?, idempotencyKey? |
Spaces & members
| Tool | Scope | Access | Arguments |
|---|---|---|---|
list_spacesList Spaces List the spaces (workspaces) in your organization. | tasks:read | Read-only | limit?, cursor? |
list_space_membersList Space Members List the members of a space (userUuid + username) for assignee resolution. | members:read | Read-only | spaceUuid; limit?, cursor? |
Projects & task groups
| Tool | Scope | Access | Arguments |
|---|---|---|---|
list_projectsList Projects List the projects (initiatives) in a space. | projects:read | Read-only | spaceUuid; includeArchived?, limit?, cursor? |
list_task_groupsList Task Groups List the task groups (workflow sections) in a space. | task_groups:read | Read-only | spaceUuid; limit?, cursor? |
create_projectCreate Project Create a new project (initiative) in a space. | projects:write | Writes | spaceUuid, name; description?, status?, priority?, health?, projectType?, targetDate?, startDate?, lead?, labels?, profileUuid?, enableAgent?, confirmPublication?, expectedProfileRevision? |
update_projectUpdate Project Update any subset of a project’s (initiative’s) fields (name, description, status, priority, health, projectType, targetDate, startDate, lead, labels). spaceUuid is optional (inferred from the project). | projects:write | Writes | projectId; spaceUuid?, name?, description?, status?, priority?, health?, projectType?, targetDate?, startDate?, lead?, labels?, expectedRevision? |
conclude_projectConclude Project Conclude (wrap up) a project. mode "follow_up" spins off a "Follow up <code> <name>" project (same projectType, linked to the original), moving open tasks marked "move" (default) into it and resolving the rest… | projects:write | Writes | projectId, mode; spaceUuid?, followUpName?, taskResolutions?, archiveLinkedTasks? |
create_task_groupCreate Task Group Create a task group (workflow section) in a space. | task_groups:write | Writes | spaceUuid, name; description?, position? |
update_task_groupUpdate Task Group Update a task group’s name, description, and/or sprint period (periodStart/periodEnd), and/or promote it to be the space’s default group (setDefault). spaceUuid is optional (inferred from the group). | task_groups:write | Writes | groupUuid; spaceUuid?, name?, description?, periodStart?, periodEnd?, setDefault? |
Notes
| Tool | Scope | Access | Arguments |
|---|---|---|---|
create_noteCreate Note Create a note (a decision, meeting notes or a spec) for durable prose that is not a unit of work; use create_task for work. | notes:write | Writes | spaceUuid, title; content?, contentFormat?, visibility?, groupUuid? |
list_notesList Notes List notes you can access, optionally within a single space. | notes:read | Read-only | spaceUuid?, groupUuid?, limit?, cursor? |
update_noteUpdate Note Update a note (title / content / visibility) by UUID using optimistic version locking — read the current version with fetch first. | notes:write | Writes | noteUuid, version; title?, content?, contentFormat?, visibility?, versioningEnabled?, groupUuid? |
create_note_versionCreate Note Version Take an explicit version-history snapshot of a note's CURRENT state. | notes:write | Writes | noteUuid; label? |
list_note_versionsList Note Versions List a note's version-history snapshots (newest first). | notes:read | Read-only | noteUuid; limit? |
get_note_versionGet Note Version Fetch one version-history snapshot of a note (full content) by versionNumber. | notes:read | Read-only | noteUuid, versionNumber |
restore_note_versionRestore Note Version Restore a note to a version-history snapshot. | notes:write | Writes | noteUuid, versionNumber, version |
list_note_groupsList Note Groups List the note groups (sections notes are organized into) in a space. | notes:read | Read-only | spaceUuid; limit?, cursor? |
create_note_groupCreate Note Group Create a note group (section) in a space. | notes:write | Writes | spaceUuid, name; description?, position? |
update_note_groupUpdate Note Group Update a note group’s name and/or description by UUID, and/or promote it to be the space’s default group (setDefault). | notes:write | Writes | groupUuid; spaceUuid?, name?, description?, setDefault? |
delete_note_groupDelete Note Group Delete a note group by UUID. | notes:write | Writes | groupUuid; spaceUuid? |
Labels
| Tool | Scope | Access | Arguments |
|---|---|---|---|
create_labelCreate Label Create a new color-coded label in a space. | labels:write | Writes | spaceUuid, name; color? |
list_labelsList Labels List a space's color-coded labels. | labels:read | Read-only | spaceUuid; name?, type? |
update_labelUpdate Label Update a label's name and/or color. | labels:write | Writes | labelUuid; name?, color? |
delete_labelDelete Label Delete a label by its UUID. | labels:write | Writes | labelUuid |
Attachments
| Tool | Scope | Access | Arguments |
|---|---|---|---|
list_attachmentsList Attachments List a target's attachments (task/subtask/project/note). | attachments:read | Read-only | spaceUuid, targetType, targetId |
download_attachmentsDownload Attachments Download all of a target's attachments as a single ZIP. | attachments:read | Read-only | spaceUuid, targetType, targetId |
prepare_attachment_uploadPrepare Attachment Upload Prepare a direct file upload to a task/subtask/project/note. | attachments:write | Writes | spaceUuid, targetType, targetId, filename, contentType, size |
create_attachment_from_uploadCreate Attachment from Upload Link an already-uploaded object (the assetKey from prepare_attachment_upload, after a successful PUT) to a task/subtask/project/note as an attachment row. | attachments:write | Writes | spaceUuid, targetType, targetId, assetKey, filename, contentType, size |
delete_attachmentDelete Attachment Delete a task, subtask, project, or note attachment (by its UUID) within a space. | attachments:write | Writes | spaceUuid, attachmentId |
Crews & marketplace
| Tool | Scope | Access | Arguments |
|---|---|---|---|
list_crewsList Crews List the crews (AI personas) of a space, with full persona fields (instructions, deliverables, trigger, mode, runtime config, linked skill notes). | crews:read | Read-only | spaceUuid |
list_project_crewsList Project Crews List the crews on a project's roster. | crews:read | Read-only | projectUuid |
create_crewCreate Crew Create a crew (AI persona) in a space. | crews:write | Writes | spaceUuid, name, instructions, deliverables; description?, avatar?, color?, involvementTrigger?, involvementNotes?, executionMode?, visibility?, runtime?, runtimeConfig?, skillNoteUuids?, tags? |
update_crewUpdate Crew Update any subset of a crew’s fields (name, instructions, deliverables, trigger, mode, visibility, runtime, runtimeConfig, skillNoteUuids, tags — replace-sets, [] clears). runtimeConfig is MERGED into the crew’s existing config. | crews:write | Writes | crewUuid; name?, description?, avatar?, color?, instructions?, deliverables?, involvementTrigger?, involvementNotes?, executionMode?, visibility?, runtime?, runtimeConfig?, skillNoteUuids?, tags? |
delete_crewDelete Crew Delete a crew. | crews:write | Writes | crewUuid |
submit_marketplace_listingSubmit Marketplace Listing Share one or more crews (from ONE space) to the free community marketplace for review. | crews:write | Writes | crewUuids, title, acceptedLicense; tagline?, description?, tags?, listingUuid?, publisher? |
list_my_marketplace_listingsList My Marketplace Listings Everything this workspace has submitted to the community marketplace, with the plain state of the newest version (in_review · changes_requested · live · rejected · unlisted), the reviewer note when there is one, the stored automated… | crews:read | Read-only | — |
search_marketplaceSearch The Crew Marketplace Browse the PUBLIC crew marketplace — every approved, listed bundle, free community ones and free first-party ones alike. | crews:read | Read-only | q?, tag?, limit? |
add_marketplace_crewsAdd Marketplace Crews To A Space Bring a public listing's crews into one of your spaces as real crews (with the skills they were designed with). | crews:write | Writes | listing, spaceUuid |
unlist_marketplace_listingUnlist My Marketplace Listing Withdraw one of THIS workspace's listings from the public marketplace. | crews:write | Writes | listingUuid |
relist_marketplace_listingRelist My Marketplace Listing Put a listing this workspace withdrew back on the public marketplace. | crews:write | Writes | listingUuid |
Day deck & log
| Tool | Scope | Access | Arguments |
|---|---|---|---|
get_day_deckGet Day Deck Get the tasks currently on your DayDeck — your small, focused set of in-progress tasks for today. | day_deck:read | Read-only | — |
list_day_deck_candidatesList Day Deck Candidates List the items eligible to add to your DayDeck — tasks assigned to you (backlog/todo/in_progress), plus recently-updated projects and notes in your spaces, none of them already on the deck. | day_deck:read | Read-only | limit? |
add_to_day_deckAdd to Day Deck Add an item to your DayDeck (your focus list for today). | day_deck:write | Writes | entityType?, uuid?, taskUuid?, spaceUuid? |
remove_from_day_deckRemove from Day Deck Remove an item from your DayDeck. | day_deck:write | Writes | entityType?, uuid?, taskUuid? |
list_day_logList Day Log List your DayLog — the chronological record of your own activity on tasks, subtasks, and comments (status changes and comments you made). Only listed when its feature is enabled | day_log:read | Read-only | startDate?, endDate?, limit?, cursor? |
Artifacts
| Tool | Scope | Access | Arguments |
|---|---|---|---|
publish_artifactPublish Artifact Publish a standalone HTML or Markdown artifact (a rendered document) and get its uuid back. Only listed when its feature is enabled | artifacts:write | Writes | title, contentType, content; emoji?, label?, spaceUuid?, taskUuid?, runUuid?, projectUuid? |
update_artifactUpdate Artifact Republish an artifact: store new content as the next version of the SAME artifact uuid. | artifacts:write | Writes | artifactUuid, content; title?, emoji?, label? |
list_artifactsList Artifacts List the artifacts you published, newest first. | artifacts:read | Read-only | spaceUuid?, taskUuid?, runUuid?, projectUuid?, limit?, cursor? |
Reading the table
name?is optional; a semicolon separates the required arguments from the optional ones where both exist.- Tools marked
idempotencyKeyaccept that argument, so a retried call does not create a duplicate. - Failures come back as an MCP tool error with a stable code such as
forbidden_scope,invalid_inputorrate_limited. - The catalog is a snapshot of the server’s registered tools; your client’s
tools/listis always the live answer.
Comments & notifications
add_commentAdd a comment to a task, subtask, project, or note within a space.
comments:writespaceUuid, targetType, targetId, content; crewUuid?, commentType?, requiresAck?, permissionLevel?, metadata?, parentCommentId?, sessionId?, sessionName?, branch?, worktreePath?, hostname?, os?, client?, idempotencyKey?update_commentEdit a comment on a task, subtask, project, or note within a space.
comments:writespaceUuid, targetType, targetId, commentUuid, contentdelete_commentDelete a comment from a task, subtask, project, or note within a space.
comments:writespaceUuid, targetType, targetId, commentUuidlist_commentsList the comments on a task, subtask, project, or note.
comments:readtargetId; spaceUuid?, limit?, cursor?notifySend a short message to humans about a task — it lands in their in-app inbox and as a push notification, attributed to you (actorLabel adds your crew/session name beside your username).
notifications:writeref, message; title?, targetUserUuids?, actorLabel?