Sign in
sandbox

Acquire a sandbox

Acquire an idle sandbox instance for a specific MCP server. The sandbox will be marked as 'occupied'. Optionally choose a benchmark (e.g., 'MCP_Atlas', 'Toolathlon') to configure the sandbox. IMPORTANT: The benchmark parameter may affect BOTH (1) the initial data environment (e.g., preloaded data for supported servers like Airtable, Notion, Slack, MongoDB) AND (2) the MCP server implementation itself — some servers are routed to a benchmark-specific MCP server URL (e.g., GitHub, Notion, Google Sheets). You may also specify a test_account_email to acquire a specific test account.

post/sandbox/{server_name}

Path parameters

server_name'jira' | 'github' | 'salesforce' | 'hubspot' | 'notion' | 'airtable' | 'linear' | 'asana' | 'google_sheets' | 'google_drive' | 'google_docs' | 'gmail' | 'google_calendar' | 'google_forms' | 'clickup' | 'close' | 'monday' | 'motion' | 'onedrive' | 'microsoft_teams' | 'outlook_mail' | 'cal.com' | 'quickbooks' | 'moneybird' | 'dropbox' | 'shopify' | 'woocommerce' | 'outlook_calendar' | 'resend' | 'wordpress' | 'mem0' | 'supabase' | 'slack' | 'confluence' | 'discord' | 'snowflake' | 'postgres' | 'mongodb' | 'youtube' | 'googleworkspaceatlas' | 'huggingface' | 'mock_notion' | 'arxiv_latex' | 'calculator' | 'clinicaltrialsgov' | 'fetch' | 'met_museum' | 'open_library' | 'osm' | 'pubmed' | 'us_weather' | 'duckduckgo' | 'whois' | 'wikipedia' | 'scholarly' | 'howtocook' | 'yahoo_finance' | '12306' | 'youtube_transcript' | 'weather' | 'twelvedata' | 'national_parks' | 'lara_translate' | 'e2b' | 'context7' | 'alchemy' | 'weights_and_biases' | 'oxylabs' | 'google_maps' | 'brave_search' | 'exa' | 'serper' required

Supported MCP servers for sandboxing

The MCP server name

Request body

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

Supported benchmarks for sandbox initial environment

test_account_emailstring nullable

Optional email of a specific test account to acquire. If provided, the system will attempt to acquire the sandbox associated with this test account email instead of a random idle sandbox.

tagstring nullable

Optional sandbox tag used when acquiring specific sandboxes. For mock_notion this is REQUIRED and names the template/category to clone (e.g. 'online_resume')

ttl_secondsinteger nullable

TTL in seconds. The 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

sandbox_idstring required

Unique identifier for the acquired sandbox

server_urlsobject nullable

MCP server URLs keyed by server name

server_name'jira' | 'github' | 'salesforce' | 'hubspot' | 'notion' | 'airtable' | 'linear' | 'asana' | 'google_sheets' | 'google_drive' | 'google_docs' | 'gmail' | 'google_calendar' | 'google_forms' | 'clickup' | 'close' | 'monday' | 'motion' | 'onedrive' | 'microsoft_teams' | 'outlook_mail' | 'cal.com' | 'quickbooks' | 'moneybird' | 'dropbox' | 'shopify' | 'woocommerce' | 'outlook_calendar' | 'resend' | 'wordpress' | 'mem0' | 'supabase' | 'slack' | 'confluence' | 'discord' | 'snowflake' | 'postgres' | 'mongodb' | 'youtube' | 'googleworkspaceatlas' | 'huggingface' | 'mock_notion' | 'arxiv_latex' | 'calculator' | 'clinicaltrialsgov' | 'fetch' | 'met_museum' | 'open_library' | 'osm' | 'pubmed' | 'us_weather' | 'duckduckgo' | 'whois' | 'wikipedia' | 'scholarly' | 'howtocook' | 'yahoo_finance' | '12306' | 'youtube_transcript' | 'weather' | 'twelvedata' | 'national_parks' | 'lara_translate' | 'e2b' | 'context7' | 'alchemy' | 'weights_and_biases' | 'oxylabs' | 'google_maps' | 'brave_search' | 'exa' | 'serper' required

Supported MCP servers for sandboxing

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

Status of a sandbox instance - matches database enum

messagestring required

Status message

metadataobject nullable

Per-server extras. For now only mock_notion: { task_page_id: str }.

Changes

Changed in 15 of the 50 revisions of this API.41624

  • 1f05ced7280f1See the full diff
    • ●

      removed the request property

      request-property-removed

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

  • 05c3b59aa35313See the full diff
    • ●

      added the new mock_notion enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new enum value mock_notion to the path request parameter server_name

      request-parameter-enum-value-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

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

  • 717d658593ea11See the full diff
    • ●

      removed the request property

      request-property-removed

    • ○

      added the new optional request property

      new-optional-request-property

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

  • 44a695c4d37511See the full diff
    • ●

      added the new serper enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value serper to the path request parameter server_name

      request-parameter-enum-value-added

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

  • 03e65f213cf511See the full diff
    • ●

      added the new youtube_transcript enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value youtube_transcript to the path request parameter server_name

      request-parameter-enum-value-added

  • 84dffa42632644See the full diff
    • ●

      added the new 12306 enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new howtocook enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new scholarly enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new yahoo_finance enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value 12306 to the path request parameter server_name

      request-parameter-enum-value-added

    • ○

      added the new enum value howtocook to the path request parameter server_name

      request-parameter-enum-value-added

    • ○

      added the new enum value scholarly to the path request parameter server_name

      request-parameter-enum-value-added

    • ○

      added the new enum value yahoo_finance to the path request parameter server_name

      request-parameter-enum-value-added

  • 1c6c384877371See the full diff
    • ○

      added the new MCP_Mark enum value to the request property /

      request-property-enum-value-added

  • a282ce0cd44e33See the full diff
    • ●

      added the new brave_search enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new duckduckgo enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new exa enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value brave_search to the path request parameter server_name

      request-parameter-enum-value-added

    • ○

      added the new enum value duckduckgo to the path request parameter server_name

      request-parameter-enum-value-added

    • ○

      added the new enum value exa to the path request parameter server_name

      request-parameter-enum-value-added

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

  • 809088a8d9ea11See the full diff
    • ●

      added the new google_maps enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value google_maps to the path request parameter server_name

      request-parameter-enum-value-added

  • 504a3817948822See the full diff
    • ●

      added the new fetch enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new oxylabs enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value fetch to the path request parameter server_name

      request-parameter-enum-value-added

    • ○

      added the new enum value oxylabs to the path request parameter server_name

      request-parameter-enum-value-added

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