clear_queue MCP tool

Discards undelivered follow-up messages for an agent. By default, it removes all queued and deferred messages. Pass the follow_up_id returned by queue_add to remove exactly one, whether it is still pending its deliver_at delay or already queued. Use clear_queue with the message ID to cancel a self-scheduled deferred follow-up that is no longer needed. The targeted form is idempotent and reports whether it removed anything. Equivalent to murmur queue clear and murmur queue remove in the CLI. This does not affect the agent’s current turn. Use 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 (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.
`follow_up_id`	string	no	When set, removes only this message, using the ID returned by `queue_add`, instead of clearing everything. It works whether the message is still pending its deferred delivery or already queued.
`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

Without follow_up_id, a JSON object with the number of cleared entries:

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

With follow_up_id: follow-up removed, or no undelivered follow-up with that ID (already delivered, already removed, or never queued).

Examples

Clear own queue

{}

Response:

{
  "cleared": 3
}

Cancel one deferred follow-up

{
  "slug": "fix-auth",
  "follow_up_id": "4f6c1a2e-8d3b-4f0a-9c7e-2b5d8e1f3a4c"
}

Response:

follow-up removed

Errors

Code	Meaning	What to do
`NOT_FOUND`	No agent with that slug exists.	Check the slug. Use `ls` to see running agents.
`PERMISSION_DENIED`	Caller lacks `agent.edit` on the target.	Target an agent you can edit.
`UNAUTHENTICATED`	Identity token is missing or expired.	Check credentials.

queue_add: send or defer a follow-up (returns the follow-up ID)
murmur queue clear / murmur queue remove: equivalent CLI commands
interrupt: stop the current turn
status: check agent state (includes queuedFollowUps and delayedFollowUps)

Getting Started

Core Concepts

Guides

clear_queue MCP tool

Parameters

Response

Examples

Clear own queue

Cancel one deferred follow-up

Errors

​Parameters

​Response

​Examples

​Clear own queue

​Cancel one deferred follow-up

​Errors

​Related

Parameters

Response

Examples

Clear own queue

Cancel one deferred follow-up

Errors

Related