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 the agent pushes a commit in the current run touching a file matching the pattern. Activation is evaluated against the agent’s pushed files, not against which checks CI runs. Dormant tasks don’t block the agent from finishing and shouldn’t be worked on; active incomplete tasks must be completed. Equivalent to murmur task ls in the CLI.

Parameters

Name	Type	Required	Description
`slug`	string	no	Agent slug. Empty means self. 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
`taskId`	string	The task’s unique ID.
`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`, `TASK_STATUS_DELETED`.
`blocks`	string[]	Task IDs that this task blocks.
`blockedBy`	string[]	Task IDs that block this task.
`activation`	object	Conditional activation config, if set. The task is dormant (doesn’t block the agent) until the condition is met.

Examples

List own tasks

{}

Response:

[
  {
    "taskId": "t_abc123",
    "subject": "Add pagination to the users API",
    "status": "TASK_STATUS_IN_PROGRESS"
  },
  {
    "taskId": "t_def456",
    "subject": "Update API docs",
    "status": "TASK_STATUS_PENDING",
    "blockedBy": ["t_abc123"]
  }
]

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