> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bead.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Computer use MCP

> Discover computer use MCP tools alongside account, machine, command, runner, storage, payment, and worktree capabilities.

Discover computer use MCP tools and other bead tools through your MCP client's `tools/list` support. Read all pages; the server returns 12 tools per page. Use each returned input schema for required fields.

## Account, pricing and payment

| Tools | Purpose |
| - | - |
| `account_create`, `account_claim_link` | Agent enrollment and human claiming. |
| `pricing`, `balance`, `limits`, `burst_consent` | Prices, available credit and admission controls. |
| `top_up`, `purchase_status`, `purchase_pay`, `purchase_checkout` | One prepaid purchase and its settlement. |
| `billing_autorefill_get`, `billing_autorefill_set`, `billing_card_setup`, `billing_autorefill_recover` | Admin-scoped automatic refill and card recovery. |
| `ci_key_create` | Create a scoped CI key. |

Enrollment and purchase flows require privately retained delivery state. See [signup](https://docs.bead.run/agent-signup.md) and [add credit](https://docs.bead.run/platform/top-up.md).

## Machines and templates

| Tools | Purpose |
| - | - |
| `sandbox_create`, `sandbox_list`, `sandbox_get`, `sandbox_connect` | Create, discover, inspect and connect. |
| `sandbox_pause`, `sandbox_resume`, `sandbox_delete`, `sandbox_timeout` | Lifecycle and timeout. |
| `sandbox_cost`, `sandbox_warnings` | Observed cost and warnings. |
| `sandbox_fork`, `fork_get`, `fleet_create` | Parallel machines and operation state. |
| `sandbox_snapshot_create`, `snapshot_list`, `snapshot_get`, `snapshot_delete`, `snapshot_retention`, `snapshot_retire` | Capture and manage retained snapshots. |
| `template_list`, `template_get`, `template_reserve`, `template_build`, `template_build_status`, `template_delete` | Published and custom templates. |
| `ports_set`, `network_get` | Raw port configuration and networking detail. |

## Run shell commands through an MCP sandbox

```json theme={null}
{"name":"sandbox_exec","arguments":{"id":"YOUR_MACHINE_ID","command":"uname -a","cwd":"/root"}}
```

This is a `tools/call` parameter object. Replace the machine ID with one you own.

`file_write` writes UTF-8 text up to 64 KiB. `file_download` returns a caller-authenticated download. `files` exposes `Stat`, `ListDir`, `MakeDir`, `Move` and `Remove`. `sandbox_open` returns the authenticated CLI launch command to run on your computer.

Use `result_read` for retained output. Do not repeat an uncertain command to retrieve its output.

## Runners, desktop and credentials

`runner_prompt`, `runner_events`, `runner_status`, `runner_steer`, `runner_interrupt`, `runner_approval` and `runner_restart` manage turns. `profile_list`, `profile_put`, `profile_revoke` and `profile_delete` manage credential profiles.

`desktop_start`, `desktop_watch`, `desktop_revoke`, `desktop_status`, `request_takeover` and `desktop_release` support desktop observation and human help. See [runners](https://docs.bead.run/agents/runners.md) and [takeover](https://docs.bead.run/agents/watch-takeover.md).

## Parallel jobs, CI and storage

`swarm_run`, `swarm_status`, `swarm_results`, `swarm_member` and `swarm_cancel` manage server-side command batches.

`ci`, `ci_connect`, `ci_repos`, `ci_job`, `ci_logs`, `ci_public` and `ci_disconnect` expose GitHub runner operations.

`volume_create`, `volume_list`, `volume_delete` and `volume_extend` manage retained volumes. `webhook_register`, `webhook_list`, `webhook_delete` and `webhook_deliveries` manage event delivery.

## Local worktrees

Laptop source sync, dotenv selection, local artifact storage and localhost service forwarding belong to the [worktree CLI](https://docs.bead.run/cli/worktrees.md). Use MCP machine tools to inspect remote resources, and retrieve the worktree skill through [resources](https://docs.bead.run/mcp/resources-results.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.