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

# interrupt

> MCP tool that interrupts an agent's current turn so it stops generating and can process new instructions or queued follow-ups immediately.

Interrupts an [agent's](/concepts/agents) 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`](/cli/session-interrupt) in the CLI.

The interrupt + [`queue_add`](/mcp-server/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`](/mcp-server/kill) instead if you want to terminate the agent entirely, or [`clear_queue`](/mcp-server/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/u/account/slug` to target an agent outside your own path. |
| `workspace` | string | no       | Workspace name. Overrides the session default.                                                                                  |

## Response

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

## Examples

### Interrupt an agent

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

Response:

```
interrupt sent to fix-auth
```

### Interrupt then redirect

First, interrupt the current turn:

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

Then send new instructions with [`queue_add`](/mcp-server/queue-add):

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

### Interrupt using absolute path

```json theme={null}
{
  "slug": "/w/backend/u/bob/api-refactor"
}
```

## 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 session interrupt`](/cli/session-interrupt) — equivalent CLI command
* [`queue_add`](/mcp-server/queue-add) — send follow-up to a running agent
* [`clear_queue`](/mcp-server/clear-queue) — discard queued follow-ups
* [`kill`](/mcp-server/kill) — cancel an agent entirely
* [`status`](/mcp-server/status) — check agent state