clear_queue MCP tool

Discards undelivered follow-up messages for an agent without delivering them: all of them (queued and deferred) by default, or exactly one by its follow_up_id (returned by queue_add) — whether still pending its deliver_at delay or already sitting in the queue. Cancelling a self-scheduled deferred follow-up (a “resume me at T” you no longer need) is clear_queue with that message’s ID. The targeted form is idempotent: it reports whether anything was removed. 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. 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 (the ID `queue_add` returned) — deferred or queued — instead of clearing everything.
`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
`FAILED_PRECONDITION`	Targeted removal against an agent pinned to a pre-182 build without the queue-remove handler.	Upgrade the agent with `murmur can`.
`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