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

# Overview

> Manage Bonya sandboxes from any MCP client

`@bonya-ai/bonya-mcp` is a [Model Context Protocol](https://modelcontextprotocol.io) server for the Bonya Compute REST API. It lets any MCP client — Claude Desktop, Claude Code, Cursor, and others — create and manage **sandboxes**, run commands, work with files, manage long-lived background **sessions**, create **preview** URLs, and run one-off or scheduled **jobs**, all through tool calls instead of raw HTTP.

> [!NOTE]
>
> The server is self-contained: it talks to the Bonya Compute REST API directly and does not depend on the `@bonya-ai/bonya` or `bonya` SDKs. It covers the same public API as the [API reference](https://docs.bonya.ai/api-reference).

## Tool groups

The server registers 63 tools across these groups:

> [card] Sandboxes
>
> Create, list, inspect, delete, pause, keep awake, fork, and restrict the network of sandboxes, including GPU sandboxes.

> [card] Exec & filesystem
>
> Run buffered commands (`sandbox_exec`) and read, write, list, stat, create, rename, and delete files.

> [card] Sessions
>
> Create, list, and kill named background sessions for long-running processes.

> [card] Previews
>
> Publish a port at an HTTPS URL, with private (grant token) or public access.

> [card] Snapshots
>
> Capture a sandbox's disk state and restore it into a new sandbox.

> [card] Jobs & schedules
>
> Run one-off or scheduled jobs on a new or existing sandbox and track them to completion.

> [card] Templates
>
> Saved, versioned launch configurations.

> [card] Secrets & registries
>
> Write-only secrets, secret sets, and private registry connections.

> [card] [Setup](https://docs.bonya.ai/mcp/setup.md)
>
> Install the server and connect it to your MCP client.

> [card] [Tools](https://docs.bonya.ai/mcp/tools.md)
>
> Full reference for all 63 tools, including parameters and return values.

## What's out of scope

* **Interactive/streaming endpoints**: the API's WebSocket surfaces (TTY `exec`, session `attach`) don't fit a request/response MCP tool call. `sandbox_exec` covers non-interactive buffered commands, and `session_create` covers long-running background processes.
* **Identity management**: creating organizations, members, invites and API keys isn't available to API keys.
* **Billing and usage**: not part of the public API.


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