> ## 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.

# clear_queue

> MCP tool that discards all queued follow-up messages for an agent without delivering them — used to recover from bad or stale instructions.

Discards all queued follow-up messages for an [agent](/concepts/agents) without delivering them. Returns the number of entries cleared.

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

This does not affect the agent's current turn. Use [`interrupt`](/mcp-server/interrupt) if you also want to stop the in-progress turn.

## Parameters

| Name        | Type   | Required | Description                                                                                                                          |
| ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `slug`      | string | no       | Agent task slug. Empty means self. Use an absolute path like `/w/workspace/u/account/slug` to target an agent outside your own path. |
| `workspace` | string | no       | Workspace name. Overrides the session default.                                                                                       |

## Response

Returns a JSON object with the number of cleared entries.

| Field     | Type    | Description                             |
| --------- | ------- | --------------------------------------- |
| `cleared` | integer | Number of follow-up messages discarded. |

## Examples

### Clear own queue

```json theme={null}
{}
```

Response:

```json theme={null}
{
  "cleared": 3
}
```

### Clear another agent's queue

```json theme={null}
{
  "slug": "fix-auth"
}
```

Response:

```json theme={null}
{
  "cleared": 1
}
```

## 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. |
| `UNAUTHENTICATED` | Identity token is missing or expired. | Check credentials.                                                |

## Related

* [`murmur queue clear`](/cli/queue-clear) — equivalent CLI command
* [`queue_add`](/mcp-server/queue-add) — send follow-up to a running agent
* [`interrupt`](/mcp-server/interrupt) — stop the current turn
* [`status`](/mcp-server/status) — check agent state (includes `queuedFollowUps`)