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

# kill

> MCP tool that permanently cancels an agent and its entire subtree of child agents, releasing every associated VM back to the pool.

Cancels an [agent](/concepts/agents) task and its entire subtree of child agents. The agent's VM is terminated and all in-progress work stops.

Equivalent to [`murmur kill`](/cli/kill) in the CLI.

<Warning>This is a destructive operation. The agent and all its children are permanently cancelled. Use [`interrupt`](/mcp-server/interrupt) if you only want to stop the current turn.</Warning>

## Parameters

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

## Examples

### Kill an agent

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

Response:

```
killed fix-auth
```

### Kill 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 kill`](/cli/kill) — equivalent CLI command
* [`interrupt`](/mcp-server/interrupt) — stop the current turn without killing the agent
* [`ls`](/mcp-server/ls) — list running agents
* [`status`](/mcp-server/status) — check agent state
* [`spawn`](/mcp-server/spawn) — create an agent