Skip to main content
@bonya-ai/bonya-mcp is a Model Context Protocol 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.
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.

​
Tool groups

The server registers 63 tools across these groups:

Sandboxes

Create, list, inspect, delete, pause, keep awake, fork, and restrict the network of sandboxes, including GPU sandboxes.

Exec & filesystem

Run buffered commands (sandbox_exec) and read, write, list, stat, create, rename, and delete files.

Sessions

Create, list, and kill named background sessions for long-running processes.

Previews

Publish a port at an HTTPS URL, with private (grant token) or public access.

Snapshots

Capture a sandbox’s disk state and restore it into a new sandbox.

Jobs & schedules

Run one-off or scheduled jobs on a new or existing sandbox and track them to completion.

Templates

Saved, versioned launch configurations.

Secrets & registries

Write-only secrets, secret sets, and private registry connections.

Setup

Install the server and connect it to your MCP client.

Tools

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.