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

# Reference map and compatibility

> Find REST endpoints, Python methods, CLI commands, and MCP tools for your workflow.

Task guides explain complete workflows. Use the interface reference for exact fields, defaults, response schemas, and errors.

## Choose a reference

The Python examples use `contree-sdk==0.3.6`; CLI examples use `contree-cli==0.9.4`. Keep these versions when following the examples.

| Interface | Use the reference for |
| - | - |
| Python SDK | Image objects, async and synchronous execution, file transfer, and sessions |
| CLI | Authentication profiles, image selection, commands, and local session management |
| REST | Request and response fields, operation status, SSE events, and subprocess control |
| MCP | Tools and resources available to an MCP client; check the tool list exposed by your connected server |

The REST base URL is `https://api.tokenfactory.nebius.com/sandboxes/v1`.

## REST operations

* [Spawn an operation](/api-reference/sandboxes/instances/spawn-a-new-container-instance)
* [List operations](/api-reference/sandboxes/operations/list-operations)
* [Get operation status](/api-reference/sandboxes/operations/get-an-operation-status)
* [Cancel an operation](/api-reference/sandboxes/operations/cancel-an-operation)
* [Stream operation events](/api-reference/sandboxes/operations/stream-the-operation-event-log-via-server-sent-events)
* [Spawn an additional subprocess](/api-reference/sandboxes/operation/spawn-an-additional-subprocess-inside-a-running-instance)
* [Get a subprocess result](/api-reference/sandboxes/operation/result-of-one-subprocess-reconstructed-from-its-events)
* [Signal a subprocess](/api-reference/sandboxes/operation/kill-one-subprocess)
* [Write to subprocess stdin](/api-reference/sandboxes/operation/write-to-a-subprocesss-stdin-andor-close-it)

## Images and files

* [List public images](/api-reference/sandboxes/images/list-publicly-available-images)
* [Import an OCI image](/api-reference/sandboxes/images/import-a-container-image-from-a-registry)
* [Inspect an image](/api-reference/sandboxes/inspect/inspect-an-image)
* [List files in an image](/api-reference/sandboxes/inspect/list-files-in-image)
* [Download a file](/api-reference/sandboxes/inspect/download-a-file-from-image)
* [Download a file or directory as an archive](/api-reference/sandboxes/inspect/download-a-file-or-a-directory-from-image-as-tar-archive)

## Python SDK

* [SDK overview](/sandboxes/sdk/index)
* [Getting started](/sandboxes/sdk/python_sdk/getting-started)
* [Running commands](/sandboxes/sdk/python_sdk/running-commands)
* [Python API reference](/sandboxes/sdk/python_sdk/reference/index)
* [Image reference](/sandboxes/sdk/python_sdk/reference/image)
* [Session reference](/sandboxes/sdk/python_sdk/reference/session)
* [Subprocess-style wrapper](/sandboxes/sdk/python_sdk/reference/subprocess)

## CLI

* [CLI overview](/sandboxes/cli/index)
* [Install and authenticate](/sandboxes/cli/tutorial/installation)
* [Tutorial](/sandboxes/cli/tutorial/index)
* [Command reference](/sandboxes/cli/commands/index)
* [Sessions, branches, and rollback](/sandboxes/cli/tutorial/sessions)

## MCP

* [MCP overview](/sandboxes/mcp/index)
* [Quickstart](/sandboxes/mcp/quickstart)
* [Tools reference](/sandboxes/mcp/tools/index)
* [Resources](/sandboxes/mcp/resources)
* [Configuration](/sandboxes/mcp/integration/configuration)

MCP provides tools for commands, images, files, and operation lookup, waiting, and cancellation. For SSE streaming or additional-process controls, use the REST endpoints above. Check your connected server's tool list before configuring an MCP workflow.

## Capability routes

| Task | Route |
| - | - |
| First stateful SDK run | [Python quickstart](/sandboxes/start/python-quickstart) |
| First stateful CLI run | [CLI quickstart](/sandboxes/start/cli-quickstart) |
| Persistence defaults and result identity | [Images, checkpoints, and branches](/sandboxes/concepts/images-checkpoints-and-branches) |
| Submit, poll, and inspect results | [Run commands and handle results](/sandboxes/guides/run-commands-and-results) |
| Stream and resume output | [Stream output and events](/sandboxes/guides/stream-output-and-events) |
| Control an additional process | [Run subprocesses and send input](/sandboxes/guides/run-subprocesses-and-send-input) |
| Diagnose a failed workflow | [Troubleshooting](/sandboxes/operate/troubleshooting) |