Tasks and agents

This page is generated from mcp-catalog.json. Do not edit it by hand.

Source: paper3 local extraction on 2026-05-29. Generated: 2026-05-29T11:34:45.044Z.

`append_task_message`

Append a system note to a task

Drop a short note into another task's transcript — used for inter-agent communication. The Manager can leave context for the Designer; the Tech agent can leave a status update on a Legal task. Always tagged role:system so it doesn't trigger the assigned agent's loop.

Parameters

Parameter	Type	Required	Description
`taskId`	`string`	Yes
`content`	`string`	Yes
`callerAgentId`	`string`	No
`_site`	`string`	No	Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.

Input schema

{
  "type": "object",
  "properties": {
    "taskId": {
      "type": "string"
    },
    "content": {
      "type": "string"
    },
    "callerAgentId": {
      "type": "string"
    },
    "_site": {
      "type": "string",
      "description": "Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.",
      "pattern": "^[^/]+/[^/]+$"
    }
  },
  "required": [
    "taskId",
    "content"
  ],
  "additionalProperties": false
}

`assign_task`

Assign a task to an agent (auto-runs)

Reassign a task to another agent and immediately fire that agent's runtime loop. The Manager's primary routing tool: pick a specialist with list_agents, hand them the task here, and they'll start working in the background. Pass assigneeKind:'user' (assigneeId omitted) to hand the task back to the user instead.

Parameters

Parameter	Type	Required	Description
`taskId`	`string`	Yes
`assigneeId`	`string`	No
`assigneeKind`	`string`	No
`_site`	`string`	No	Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.

Input schema

{
  "type": "object",
  "properties": {
    "taskId": {
      "type": "string"
    },
    "assigneeId": {
      "type": "string"
    },
    "assigneeKind": {
      "type": "string",
      "enum": [
        "user",
        "agent"
      ]
    },
    "_site": {
      "type": "string",
      "description": "Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.",
      "pattern": "^[^/]+/[^/]+$"
    }
  },
  "required": [
    "taskId"
  ],
  "additionalProperties": false
}

`create_task`

Create a new task

Create a task on the workspace backlog. Use when decomposing a large goal into subtasks, opening new work for a teammate agent, or queueing follow-up. Pass parentId to link the new task as a subtask of an existing one. assigneeId can target a specific agent (use list_agents to see available specialists).

Parameters

Parameter	Type	Required	Description
`title`	`string`	Yes
`description`	`string`	No
`category`	`string`	No
`priority`	`string`	No
`status`	`string`	No
`assigneeKind`	`string`	No
`assigneeId`	`unknown`	No
`parentId`	`string`	No
`labels`	`array`	No
`href`	`string`	No
`callerAgentId`	`string`	No
`_site`	`string`	No	Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.

Input schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "category": {
      "type": "string",
      "enum": [
        "general",
        "structure",
        "responsive",
        "legal",
        "seo",
        "geo",
        "domain",
        "analytics",
        "performance",
        "accessibility"
      ]
    },
    "priority": {
      "type": "string",
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "backlog",
        "todo",
        "in_progress",
        "blocked",
        "review",
        "done",
        "cancelled"
      ]
    },
    "assigneeKind": {
      "type": "string",
      "enum": [
        "user",
        "agent"
      ]
    },
    "assigneeId": {},
    "parentId": {
      "type": "string"
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "href": {
      "type": "string"
    },
    "callerAgentId": {
      "type": "string"
    },
    "_site": {
      "type": "string",
      "description": "Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.",
      "pattern": "^[^/]+/[^/]+$"
    }
  },
  "required": [
    "title"
  ],
  "additionalProperties": false
}

`get_task`

Get task detail

Return one task with its full transcript. Use to inspect what another agent has done, or to read the conversation context before delegating.

Parameters

Parameter	Type	Required	Description
`taskId`	`string`	Yes
`_site`	`string`	No	Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.

Input schema

{
  "type": "object",
  "properties": {
    "taskId": {
      "type": "string"
    },
    "_site": {
      "type": "string",
      "description": "Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.",
      "pattern": "^[^/]+/[^/]+$"
    }
  },
  "required": [
    "taskId"
  ],
  "additionalProperties": false
}

`list_agents`

List the agent fleet

Return every agent on the workspace with their role, model, skills, and status. Use this when routing a task — match the work to the specialist whose skills line up.

Parameters

Parameter	Type	Required	Description
`_site`	`string`	No	Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.

Input schema

{
  "type": "object",
  "properties": {
    "_site": {
      "type": "string",
      "description": "Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.",
      "pattern": "^[^/]+/[^/]+$"
    }
  },
  "additionalProperties": false
}

`list_tasks`

List tasks

List every task on the workspace, optionally filtered by status / category / assignee. Use this BEFORE creating a new task so you don't duplicate one that's already in the backlog. Each entry is a thin summary; call get_task to drill into the messages.

Parameters

Parameter	Type	Required	Description
`status`	`string`	No
`category`	`string`	No
`assigneeKind`	`string`	No
`assigneeId`	`string`	No
`includeDone`	`boolean`	No
`includeCancelled`	`boolean`	No
`_site`	`string`	No	Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.

Input schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "backlog",
        "todo",
        "in_progress",
        "blocked",
        "review",
        "done",
        "cancelled"
      ]
    },
    "category": {
      "type": "string",
      "enum": [
        "general",
        "structure",
        "responsive",
        "legal",
        "seo",
        "geo",
        "domain",
        "analytics",
        "performance",
        "accessibility"
      ]
    },
    "assigneeKind": {
      "type": "string",
      "enum": [
        "user",
        "agent"
      ]
    },
    "assigneeId": {
      "type": "string"
    },
    "includeDone": {
      "type": "boolean"
    },
    "includeCancelled": {
      "type": "boolean"
    },
    "_site": {
      "type": "string",
      "description": "Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.",
      "pattern": "^[^/]+/[^/]+$"
    }
  },
  "additionalProperties": false
}

`update_agent_memory`

Update an agent's persistent memory

Overwrite an agent's memory file. Use for YOUR OWN agentId (your id is in the system prompt) to record durable insights you want to remember across runs. Append to the existing memory rather than overwriting blindly — call get_agent first if you're unsure of the current contents.

Parameters

Parameter	Type	Required	Description
`agentId`	`string`	Yes
`memory`	`string`	Yes
`_site`	`string`	No	Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.

Input schema

{
  "type": "object",
  "properties": {
    "agentId": {
      "type": "string"
    },
    "memory": {
      "type": "string"
    },
    "_site": {
      "type": "string",
      "description": "Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.",
      "pattern": "^[^/]+/[^/]+$"
    }
  },
  "required": [
    "agentId",
    "memory"
  ],
  "additionalProperties": false
}

`update_business_memory`

Update the shared business memory

Overwrite the shared business memory readable by every agent. Use for durable facts about the brand, audience, voice, product principles. Every agent reads this before each run, so keep it crisp — bullets, not essays. Append to existing content rather than blank-overwriting.

Parameters

Parameter	Type	Required	Description
`memory`	`string`	Yes
`_site`	`string`	No	Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.

Input schema

{
  "type": "object",
  "properties": {
    "memory": {
      "type": "string"
    },
    "_site": {
      "type": "string",
      "description": "Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.",
      "pattern": "^[^/]+/[^/]+$"
    }
  },
  "required": [
    "memory"
  ],
  "additionalProperties": false
}

`update_task`

Update a task

Patch an existing task. Use to flip status (backlog → todo → in_progress → review → done), bump priority, refine the description, or change category. ONLY include the fields you want to change. To reassign a task to a different agent, prefer assign_task so the runtime auto-fires the new owner.

Parameters

Parameter	Type	Required	Description
`taskId`	`string`	Yes
`title`	`string`	No
`description`	`string`	No
`status`	`string`	No
`priority`	`string`	No
`category`	`string`	No
`labels`	`array`	No
`href`	`string`	No
`_site`	`string`	No	Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.

Input schema

{
  "type": "object",
  "properties": {
    "taskId": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "backlog",
        "todo",
        "in_progress",
        "blocked",
        "review",
        "done",
        "cancelled"
      ]
    },
    "priority": {
      "type": "string",
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ]
    },
    "category": {
      "type": "string",
      "enum": [
        "general",
        "structure",
        "responsive",
        "legal",
        "seo",
        "geo",
        "domain",
        "analytics",
        "performance",
        "accessibility"
      ]
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "href": {
      "type": "string"
    },
    "_site": {
      "type": "string",
      "description": "Optional target site formatted as <workspaceSlug>/<siteSlug>. Required when the workspace has multiple sites and no site header is set.",
      "pattern": "^[^/]+/[^/]+$"
    }
  },
  "required": [
    "taskId"
  ],
  "additionalProperties": false
}

On this page