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

# mcpbox-snapshots create

> Create MCP Box Snapshot

Starts an asynchronous build and returns the MCP Box Snapshot with status pending. Get the Snapshot until its status is ready, failed or canceled; MCP Boxes serve a ready one. The build makes an MCP server that answers from the API Box Snapshot it names, run in real time: with a credential, it copies the live MCP server at the credential's base\_url; without one, the server its instructions or research name. Builds queue with Simulator builds and count toward the same quotas. Send multipart/form-data with a JSON part named request and optional file parts named document with vendor documentation.

```bash theme={null}
continuous mcpbox-snapshots create [flags]
```

## Examples

```bash theme={null}
continuous mcpbox-snapshots create
```

## Flags

**--document** `string`

Vendor documentation the builder and reviewer read before they start, as repeated file parts: UTF-8 text (.md, .txt, .html, .json, .yaml, .xml, .csv) or PDF (.pdf). The documents share the request body limit.

**--idempotency-key, -i** `string`

Optional key for retrying this create safely. A retry with the same key and request returns the original result with its status; the same key with a different request returns 409 idempotency\_conflict. Without a key, each request creates a new resource. The key is recorded before the build starts, so a retry never starts a second build.

**--request, -r** `string` *required*

Request as JSON

Global flags apply to every command. See [Global flags](https://docs.continuouslabs.ai/cli/global-flags.md).


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