> ## Documentation Index
> Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# queue_add

> MCP tool that sends a follow-up message to a running agent — delivered according to the active queue strategy after the current turn ends.

Sends a follow-up message to a running [agent](/concepts/agents). The message is queued and delivered when the agent is ready to process it. Returns an error if the agent is not running.

Equivalent to [`murmur queue add`](/cli/queue-add) in the CLI.

Follow-ups are delivered according to the agent's [dequeue strategy](/mcp-server/spawn#parameters) — `all` (drain everything), `one` (one per turn), or `five` (up to five per turn).

## Parameters

| Name          | Type      | Required | Description                                                                                                        |
| ------------- | --------- | -------- | ------------------------------------------------------------------------------------------------------------------ |
| `slug`        | string    | yes      | Agent task slug. Use an absolute path like `/w/workspace/u/account/slug` to target an agent outside your own path. |
| `description` | string    | yes      | Follow-up message to send to the running agent.                                                                    |
| `tasks`       | string\[] | no       | Checklist items to add to the agent's task list.                                                                   |
| `agent`       | string    | no       | Agent persona override (e.g. `programmer`, `architect`).                                                           |
| `workspace`   | string    | no       | Workspace name. Overrides the session default.                                                                     |

## Response

Returns a confirmation string: `follow-up sent to <slug>`.

## Examples

### Send a follow-up message

```json theme={null}
{
  "slug": "fix-auth",
  "description": "Also fix the session expiry logic while you're in that file."
}
```

Response:

```
follow-up sent to fix-auth
```

### Send a follow-up with new tasks

```json theme={null}
{
  "slug": "fix-auth",
  "description": "Here are additional items to handle.",
  "tasks": ["Add rate limiting to the login endpoint", "Update the API docs"]
}
```

### Interrupt then redirect

Use [`interrupt`](/mcp-server/interrupt) to stop the current turn, then send new instructions:

```json theme={null}
{
  "slug": "fix-auth",
  "description": "Stop what you're doing. Focus on the login handler instead."
}
```

## Errors

| Code                  | Meaning                               | What to do                                                                      |
| --------------------- | ------------------------------------- | ------------------------------------------------------------------------------- |
| `NOT_FOUND`           | No agent with that slug exists.       | Check the slug. Use [`ls`](/mcp-server/ls) to see running agents.               |
| `FAILED_PRECONDITION` | Agent is not running.                 | Use [`spawn`](/mcp-server/spawn) with `resurrect: true` to resume a dead agent. |
| `UNAUTHENTICATED`     | Identity token is missing or expired. | Check credentials.                                                              |

## Related

* [`murmur queue add`](/cli/queue-add) — equivalent CLI command
* [`interrupt`](/mcp-server/interrupt) — stop the current turn before sending a follow-up
* [`clear_queue`](/mcp-server/clear-queue) — discard queued follow-ups
* [`status`](/mcp-server/status) — check agent state
* [`spawn`](/mcp-server/spawn) — create an agent