local-sandbox

Acquire a local sandbox

Initializes a specialized Virtual Machine environment (Local Sandbox) that hosts multiple interconnected MCP servers. Optionally specify a benchmark (e.g., 'Toolathlon') to configure the sandbox. IMPORTANT: The benchmark parameter may affect BOTH (1) the initial data environment (e.g., preloaded data or pre-configured state for supported servers) AND (2) the MCP server implementation itself — some servers may be routed to a benchmark-specific MCP server with potentially different tools or behaviors.

post/local-sandbox

Request body

benchmark'MCP_Atlas' | 'Toolathlon' | 'MCP_Mark'

Supported benchmarks for sandbox initial environment

test_account_emailstring nullable

Specific test account email

ttl_secondsinteger nullable

TTL in seconds. The local sandbox will be automatically released after this duration. Default: 7200 (2 hours). Min: 60 (1 minute). Max: 86400 (24 hours). Set to null to disable auto-release.

Response

Successful Response

local_sandbox_idstring required

Unique identifier for the entire local sandbox environment

status'idle' | 'occupied' | 'error'

Status of a sandbox instance - matches database enum

benchmarkstring nullable

Benchmark environment configuration used for the local sandbox

messagestring nullable

Status message

Changes

Changed in 10 of the 50 revisions of this API.414

    • response property servers/items/tags list-of-types was widened by adding types array to media type application/json of response 201

      response-property-list-of-types-widened

    • the /// response's property type changed from object to array for status

      response-property-type-changed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 84dffa42632611See the full diff
    • removed the enum value playwright_toolathlon of the request property //

      request-property-enum-value-removed

    • added the new playwright enum value to the request property //

      request-property-enum-value-added

    • added the new playwright_toolathlon enum value to the request property //

      request-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • removed the enum value canvas_toolathlon of the request property //

      request-property-enum-value-removed

    • added the new canvas enum value to the request property //

      request-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new MCP_Mark enum value to the request property /

      request-property-enum-value-added

    • added the new canvas_toolathlon enum value to the request property //

      request-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new optional request property

      new-optional-request-property

    • added the new localmemory enum value to the request property //

      request-property-enum-value-added

    This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the optional property // to the response with the status

      response-optional-property-added

    • added the optional property // to the response with the status

      response-optional-property-added

    • added the optional property // to the response with the status

      response-optional-property-added

    • added the optional property // to the response with the status

      response-optional-property-added

    • added the optional property // to the response with the status

      response-optional-property-added

    • added the optional property // to the response with the status

      response-optional-property-added

    • endpoint added

      endpoint-added