task_list MCP tool

Lists all tasks in an agent’s checklist. Returns a JSON array of task objects including their IDs, subjects, statuses, and dependency edges. A task with an activation condition is dormant until the condition is met. filesModified activates once a push in the current run changes a file matching the pattern, relative to the PR base branch. It is evaluated against the branch’s net changes against its base: files brought in by merging or syncing the base branch don’t count, and neither does what CI runs. Dormant tasks don’t block the agent from finishing and shouldn’t be worked on. Active incomplete tasks must be resolved as completed, or as not applicable with a reason. filesModified tasks are run-scoped. A resolved one resets to pending at the start of each new run, so it must be resolved again if that run again modifies matching files. Equivalent to murmur task ls in the CLI.

Parameters

Name	Type	Required	Description
`slug`	string	no	Agent slug. Empty means self (on VMs). Use an absolute path like `/w/{workspace}/{owner_provider}/{account}/{slug}` (e.g. `/w/backend/github_oauth/alice/fix-auth`) to target an agent outside your own path.
`workspace`	string	no	Workspace name. Overrides the session default. Required only when nothing else supplies one: off a VM, with no session default, and with a slug that is not a `/w/{workspace}/...` path.

Response

Returns a JSON array of task objects.

Field	Type	Description
`id`	string	The task’s ID, unique within the agent’s checklist (e.g. `"1"`).
`subject`	string	Short summary of the task.
`description`	string	Detailed task description.
`status`	string	Task status: `TASK_STATUS_PENDING`, `TASK_STATUS_IN_PROGRESS`, `TASK_STATUS_COMPLETED`, or `TASK_STATUS_NOT_APPLICABLE`.
`blocks`	string[]	Task IDs that this task blocks.
`blockedBy`	string[]	Task IDs that block this task.
`activation`	object	Activation condition, if set (e.g. `{"filesModified": {"pattern": "*/_test.go"}}`). The task is dormant, and does not block the agent, until the condition is met.
`notApplicableReason`	string	Why the task does not apply. Set only when the status is `TASK_STATUS_NOT_APPLICABLE`.
`persona`	string	The persona that contributed the task (e.g. `programmer`). Empty for tasks from the spawn request, follow-ups, or `task_create`.
`ephemeral`	boolean	`true` for a task that lives for one run only, such as a per-thread PR comment task.
`resolvedRunId`	number	The run in which the task was resolved. Absent while the task is unresolved.

Fields are present only when they have a value.

Examples

List own tasks

{}

Response:

[
  {
    "id": "1",
    "subject": "Add pagination to the users API",
    "status": "TASK_STATUS_IN_PROGRESS",
    "blocks": ["2"]
  },
  {
    "id": "2",
    "subject": "Update API docs",
    "status": "TASK_STATUS_PENDING",
    "blockedBy": ["1"]
  }
]

List another agent’s tasks

{
  "slug": "fix-auth"
}

Errors

Code	Meaning	What to do
`NOT_FOUND`	No agent with that slug exists.	Check the slug. Use `ls` to see running agents.
`UNAUTHENTICATED`	Identity token is missing or expired.	Check credentials.

murmur task ls: equivalent CLI command
task_create: create a new task
task_update: update a task
task_get: get a single task by ID

Getting Started

Core Concepts

Guides

task_list MCP tool

Parameters

Response

Examples

List own tasks

List another agent’s tasks

Errors

​Parameters

​Response

​Examples

​List own tasks

​List another agent’s tasks

​Errors

​Related

Parameters

Response

Examples

List own tasks

List another agent’s tasks

Errors

Related