Skip to content

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

ToolScopeAccessArguments
list_tasks_and_subtasks
List Tasks & Subtasks

List tasks AND their subtasks, filtered by space, status, assignee ("me", a user UUID, or a username), project, and/or group.

tasks:readRead-onlyspaceUuid?, 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_task
Update 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:writeWritestaskUuid?, spaceUuid?, status?, priority?, title?, description?, assignee?, assignees?, reviewer?, labels?, groupUuid?, projectUuid?, dueDate?, prUrl?, isBlocked?, sessionId?, sessionName?, branch?, worktreePath?, hostname?, os?, client?, items?
create_task
Create Task

Create a top-level task in a space.

tasks:writeWrites
idempotencyKey
spaceUuid?, title?, description?, status?, priority?, groupUuid?, projectUuid?, assignee?, assignees?, reviewer?, labels?, proposedGroupName?, proposedGroupDescription?, idempotencyKey?, items?
create_subtask
Create Subtask

Create a subtask under a parent task (a step of the parent, not a separate ticket); use create_task for standalone work.

subtasks:writeWrites
idempotencyKey
spaceUuid, parentTaskId, title; description?, assignees?, labels?, idempotencyKey?, sessionId?, sessionName?, branch?, worktreePath?, hostname?, os?, client?
get_agent_context
Get Agent Context

Diagnose YOUR OWN run: the agent-context report for the calling organization.

tasks:readRead-onlysurface?
fetch
Fetch 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:readRead-onlyref; type?
search
Search Workspace

Full-text search across tasks, subtasks, projects, notes, task comments, task groups, and labels.

tasks:readRead-onlyquery; type?, spaceUuid?, space?, mentions?, limit?, cursor?
list_subtasks
List Subtasks

List the subtasks of a task.

subtasks:readRead-onlytaskUuid?, spaceUuid?, limit?, cursor?
update_subtask
Update Subtask

Update any subset of a subtask’s fields (title, description, status, assignee, labels). spaceUuid is optional (inferred from the subtask).

subtasks:writeWritessubtaskUuid; spaceUuid?, title?, description?, status?, assignee?, assignees?, labels?, sessionId?, sessionName?, branch?, worktreePath?, hostname?, os?, client?
start_work
Start Work

Begin a unit of work and get the ticket to work on.

tasks:writeWritesspaceUuid?, title?, sessionId?, sessionName?, worktreePath?, branch?, hostname?, os?, client?, model?
suggest_group
Suggest Group

Decide where a new task belongs in a space, from groups' learned memory.

tasks:readRead-onlyspaceUuid, title; description?, newAreaOfWork?, proposedGroupName?, proposedGroupDescription?, proposedSpaceName?, proposedSpaceDescription?
link_entities
Link Entities

Link two entities (task ↔ project ↔ note, any pair) so each shows in the other's links.

tasks:writeWritessource, target; sourceType?, targetType?, role?
unlink_entities
Unlink Entities

Remove the link between two entities (task/project/note, by UUID or app URL).

tasks:writeWritessource, target; sourceType?, targetType?
list_favorites
List Favorites

List your favorites (personal pins) across tasks, task groups, projects, notes, and clients.

Only listed when its feature is enabled
tasks:readRead-onlyentityType?, limit?, cursor?
get_plan_guide
Get 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:readRead-onlyplan?, compare?
get_workspace_plan
Get 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:readRead-only—

Agent runs & profiles

ToolScopeAccessArguments
list_machines
List 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:readRead-onlyspaceUuid?
configure_project_agent
Configure 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:writeWritesprojectUuid; expectedRevision?, machineUuid?, agentEnabled?, executor?, dispatchMode?, autonomy?, routingMode?, workspaceMode?, localRepoPath?, maxConcurrency?, op?, profileUuid?, expectedProfileRevision?, dryRun?, confirmPublication?
launch_task
Launch Task

Hand an existing task to the fleet.

Only while agent runs are enabled for the workspace
tasks:writeWrites
idempotencyKey
taskUuid?, machineUuid?, baseRef?, dryRun?, steer?, follow?, idempotencyKey?, items?
cancel_run
Cancel 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:writeWrites
idempotencyKey
taskUuid?, claimUuid?, idempotencyKey?
list_runs
List 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:readRead-onlyprojectUuid?, taskUuid?, machineUuid?, executor?, outcome?, executionKind?, startedAfter?, startedBefore?, limit?, cursor?
get_run
Get 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:readRead-onlyrunUuid; logTailLines?, includeSteps?, stepsLimit?
publish_run_result
Publish 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:writeWrites
idempotencyKey
runUuid; destinationRepoUrl?, targetBranch?, expectedResultSha?, stage?, dryRun?, idempotencyKey?
export_run_artifacts
Export 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:writeWritesrunUuid; names?, dryRun?
recover_run_workspace
Recover 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:writeWritesrunUuid, machineUuid; dryRun?
preview_run_cleanup
Preview 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:readRead-onlyrunUuid
schedule_fleet_run
Schedule Fleet Run

Create a recurring or one-shot schedule that launches agent work.

Only while agent runs are enabled for the workspace
tasks:writeWritesspaceUuid, name, projectUuid, titleTemplate, scheduleKind; descriptionTemplate?, taskGroupUuid?, priority?, machineUuid?, at?, everyMinutes?, cron?, timezone?, overlapPolicy?, profileSelection?, profileVersion?
list_fleet_schedules
List 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:readRead-onlyspaceUuid
cancel_fleet_schedule
Cancel Fleet Schedule

Delete a fleet-launch schedule so it stops firing.

Only while agent runs are enabled for the workspace
tasks:writeWritesspaceUuid, scheduleUuid
list_profiles
List 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:readRead-onlyspaceUuid; includeArchived?, limit?, cursor?
get_profile
Get 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:readRead-onlyprofileUuid; version?
create_profile
Create Agent Profile

Create an agent profile in a space (organization ADMINS only).

Only while agent runs are enabled for the workspace
projects:writeWrites
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_profile
Update Agent Profile

Change an agent profile (organization ADMINS only).

Only while agent runs are enabled for the workspace
projects:writeWrites
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_prefs
Set 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:writeWrites
idempotencyKey
profileUuid; preferredNodeUuid?, checkout?, idempotencyKey?

Spaces & members

ToolScopeAccessArguments
list_spaces
List Spaces

List the spaces (workspaces) in your organization.

tasks:readRead-onlylimit?, cursor?
list_space_members
List Space Members

List the members of a space (userUuid + username) for assignee resolution.

members:readRead-onlyspaceUuid; limit?, cursor?

Projects & task groups

ToolScopeAccessArguments
list_projects
List Projects

List the projects (initiatives) in a space.

projects:readRead-onlyspaceUuid; includeArchived?, limit?, cursor?
list_task_groups
List Task Groups

List the task groups (workflow sections) in a space.

task_groups:readRead-onlyspaceUuid; limit?, cursor?
create_project
Create Project

Create a new project (initiative) in a space.

projects:writeWritesspaceUuid, name; description?, status?, priority?, health?, projectType?, targetDate?, startDate?, lead?, labels?, profileUuid?, enableAgent?, confirmPublication?, expectedProfileRevision?
update_project
Update 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:writeWritesprojectId; spaceUuid?, name?, description?, status?, priority?, health?, projectType?, targetDate?, startDate?, lead?, labels?, expectedRevision?
conclude_project
Conclude 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:writeWritesprojectId, mode; spaceUuid?, followUpName?, taskResolutions?, archiveLinkedTasks?
create_task_group
Create Task Group

Create a task group (workflow section) in a space.

task_groups:writeWritesspaceUuid, name; description?, position?
update_task_group
Update 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:writeWritesgroupUuid; spaceUuid?, name?, description?, periodStart?, periodEnd?, setDefault?

Comments & notifications

ToolScopeAccessArguments
add_comment
Add Comment

Add a comment to a task, subtask, project, or note within a space.

comments:writeWrites
idempotencyKey
spaceUuid, targetType, targetId, content; crewUuid?, commentType?, requiresAck?, permissionLevel?, metadata?, parentCommentId?, sessionId?, sessionName?, branch?, worktreePath?, hostname?, os?, client?, idempotencyKey?
update_comment
Update Comment

Edit a comment on a task, subtask, project, or note within a space.

comments:writeWritesspaceUuid, targetType, targetId, commentUuid, content
delete_comment
Delete Comment

Delete a comment from a task, subtask, project, or note within a space.

comments:writeWritesspaceUuid, targetType, targetId, commentUuid
list_comments
List Comments

List the comments on a task, subtask, project, or note.

comments:readRead-onlytargetId; spaceUuid?, limit?, cursor?
notify
Notify Humans

Send 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:writeWritesref, message; title?, targetUserUuids?, actorLabel?

Notes

ToolScopeAccessArguments
create_note
Create 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:writeWritesspaceUuid, title; content?, contentFormat?, visibility?, groupUuid?
list_notes
List Notes

List notes you can access, optionally within a single space.

notes:readRead-onlyspaceUuid?, groupUuid?, limit?, cursor?
update_note
Update Note

Update a note (title / content / visibility) by UUID using optimistic version locking — read the current version with fetch first.

notes:writeWritesnoteUuid, version; title?, content?, contentFormat?, visibility?, versioningEnabled?, groupUuid?
create_note_version
Create Note Version

Take an explicit version-history snapshot of a note's CURRENT state.

notes:writeWritesnoteUuid; label?
list_note_versions
List Note Versions

List a note's version-history snapshots (newest first).

notes:readRead-onlynoteUuid; limit?
get_note_version
Get Note Version

Fetch one version-history snapshot of a note (full content) by versionNumber.

notes:readRead-onlynoteUuid, versionNumber
restore_note_version
Restore Note Version

Restore a note to a version-history snapshot.

notes:writeWritesnoteUuid, versionNumber, version
list_note_groups
List Note Groups

List the note groups (sections notes are organized into) in a space.

notes:readRead-onlyspaceUuid; limit?, cursor?
create_note_group
Create Note Group

Create a note group (section) in a space.

notes:writeWritesspaceUuid, name; description?, position?
update_note_group
Update 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:writeWritesgroupUuid; spaceUuid?, name?, description?, setDefault?
delete_note_group
Delete Note Group

Delete a note group by UUID.

notes:writeWritesgroupUuid; spaceUuid?

Labels

ToolScopeAccessArguments
create_label
Create Label

Create a new color-coded label in a space.

labels:writeWritesspaceUuid, name; color?
list_labels
List Labels

List a space's color-coded labels.

labels:readRead-onlyspaceUuid; name?, type?
update_label
Update Label

Update a label's name and/or color.

labels:writeWriteslabelUuid; name?, color?
delete_label
Delete Label

Delete a label by its UUID.

labels:writeWriteslabelUuid

Attachments

ToolScopeAccessArguments
list_attachments
List Attachments

List a target's attachments (task/subtask/project/note).

attachments:readRead-onlyspaceUuid, targetType, targetId
download_attachments
Download Attachments

Download all of a target's attachments as a single ZIP.

attachments:readRead-onlyspaceUuid, targetType, targetId
prepare_attachment_upload
Prepare Attachment Upload

Prepare a direct file upload to a task/subtask/project/note.

attachments:writeWritesspaceUuid, targetType, targetId, filename, contentType, size
create_attachment_from_upload
Create 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:writeWritesspaceUuid, targetType, targetId, assetKey, filename, contentType, size
delete_attachment
Delete Attachment

Delete a task, subtask, project, or note attachment (by its UUID) within a space.

attachments:writeWritesspaceUuid, attachmentId

Crews & marketplace

ToolScopeAccessArguments
list_crews
List Crews

List the crews (AI personas) of a space, with full persona fields (instructions, deliverables, trigger, mode, runtime config, linked skill notes).

crews:readRead-onlyspaceUuid
list_project_crews
List Project Crews

List the crews on a project's roster.

crews:readRead-onlyprojectUuid
create_crew
Create Crew

Create a crew (AI persona) in a space.

crews:writeWritesspaceUuid, name, instructions, deliverables; description?, avatar?, color?, involvementTrigger?, involvementNotes?, executionMode?, visibility?, runtime?, runtimeConfig?, skillNoteUuids?, tags?
update_crew
Update 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:writeWritescrewUuid; name?, description?, avatar?, color?, instructions?, deliverables?, involvementTrigger?, involvementNotes?, executionMode?, visibility?, runtime?, runtimeConfig?, skillNoteUuids?, tags?
delete_crew
Delete Crew

Delete a crew.

crews:writeWritescrewUuid
submit_marketplace_listing
Submit Marketplace Listing

Share one or more crews (from ONE space) to the free community marketplace for review.

crews:writeWritescrewUuids, title, acceptedLicense; tagline?, description?, tags?, listingUuid?, publisher?
list_my_marketplace_listings
List 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:readRead-only—
search_marketplace
Search The Crew Marketplace

Browse the PUBLIC crew marketplace — every approved, listed bundle, free community ones and free first-party ones alike.

crews:readRead-onlyq?, tag?, limit?
add_marketplace_crews
Add 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:writeWriteslisting, spaceUuid
unlist_marketplace_listing
Unlist My Marketplace Listing

Withdraw one of THIS workspace's listings from the public marketplace.

crews:writeWriteslistingUuid
relist_marketplace_listing
Relist My Marketplace Listing

Put a listing this workspace withdrew back on the public marketplace.

crews:writeWriteslistingUuid

Day deck & log

ToolScopeAccessArguments
get_day_deck
Get Day Deck

Get the tasks currently on your DayDeck — your small, focused set of in-progress tasks for today.

day_deck:readRead-only—
list_day_deck_candidates
List 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:readRead-onlylimit?
add_to_day_deck
Add to Day Deck

Add an item to your DayDeck (your focus list for today).

day_deck:writeWritesentityType?, uuid?, taskUuid?, spaceUuid?
remove_from_day_deck
Remove from Day Deck

Remove an item from your DayDeck.

day_deck:writeWritesentityType?, uuid?, taskUuid?
list_day_log
List 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:readRead-onlystartDate?, endDate?, limit?, cursor?

Artifacts

ToolScopeAccessArguments
publish_artifact
Publish Artifact

Publish a standalone HTML or Markdown artifact (a rendered document) and get its uuid back.

Only listed when its feature is enabled
artifacts:writeWritestitle, contentType, content; emoji?, label?, spaceUuid?, taskUuid?, runUuid?, projectUuid?
update_artifact
Update Artifact

Republish an artifact: store new content as the next version of the SAME artifact uuid.

artifacts:writeWritesartifactUuid, content; title?, emoji?, label?
list_artifacts
List Artifacts

List the artifacts you published, newest first.

artifacts:readRead-onlyspaceUuid?, 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 idempotencyKey accept 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_input or rate_limited.
  • The catalog is a snapshot of the server’s registered tools; your client’s tools/list is always the live answer.

MCP setup guide →