interrupt MCP tool

Interrupts an agent’s current turn. The agent stops cleanly between tool calls — no in-progress work is lost — and resumes by processing any queued follow-ups on its next turn. Equivalent to murmur session interrupt in the CLI. The interrupt + queue_add pattern is the standard way to amend or supersede a previously queued instruction without waiting for a long task to finish. Interrupt the agent, then immediately queue the new instruction. The agent picks up the new message on its next turn. Use kill instead if you want to terminate the agent entirely, or clear_queue if you want to drop pending follow-ups without affecting the current turn.

Parameters

Name	Type	Required	Description
`slug`	string	yes	Agent task slug to interrupt. 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.
`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

Returns a confirmation string: interrupt sent to <slug>.

Examples

Interrupt an agent

{
  "slug": "fix-auth"
}

Response:

interrupt sent to fix-auth

Interrupt then redirect

First, interrupt the current turn:

{
  "slug": "fix-auth"
}

Then send new instructions with queue_add:

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

Interrupt using absolute path

{
  "slug": "/w/backend/github_oauth/bob/api-refactor"
}

Errors

Code	Meaning	What to do
`NOT_FOUND`	No agent with that slug exists.	Check the slug. Use `ls` to see running agents.
`UNAUTHENTICATED`	Identity token is missing or expired.	Check credentials.

murmur session interrupt — equivalent CLI command
queue_add — send follow-up to a running agent
clear_queue — discard queued follow-ups
kill — cancel an agent entirely
status — check agent state

Getting Started

Core Concepts

Guides

interrupt MCP tool

Parameters

Response

Examples

Interrupt an agent

Interrupt then redirect

Interrupt using absolute path

Errors

​Parameters

​Response

​Examples

​Interrupt an agent

​Interrupt then redirect

​Interrupt using absolute path

​Errors

​Related

Parameters

Response

Examples

Interrupt an agent

Interrupt then redirect

Interrupt using absolute path

Errors

Related