Home / Servers / Vercel API / create_sandboxes_v4
Create a named sandbox
An MCP tool from the Vercel API server, hosted on mcp.hjlabs.in.
Create a named sandbox Creates a named sandbox environment. Named sandboxes have a unique name within a project and support automatic snapshotting on shutdown. When no image is provided (and the sandbox is not restored… [POST /v4/sandboxes]
Name on the gateway: vercel_api__create_sandboxes_v4 · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
teamId | string | The Team identifier to perform the request on behalf of. |
slug | string | The Team slug to perform the request on behalf of. |
networkPolicy | object | Network access policy for the sandbox.\n Controls which external hosts the… |
architecture | amd64 | arm64 | CPU architecture. Inherits a snapshot or single image manifest when omitted.… |
resources | object | Resources to define the VM |
source | object | The source from which to initialize the sandbox filesystem. Can be a Git… |
projectId | string | The target project slug or ID in which the sandbox will be assigned to. |
ports | array | List of ports to expose from the sandbox. Each port will be accessible via a… |
image | string | Image to use for the sandbox. |
timeout | integer | Maximum duration in milliseconds that the sandbox can run before being… |
env | object | Default environment variables for the sandbox. These are inherited by all… |
mounts | object | List of drives to mount to the sandbox at the provided path. |
region | iad1 | sfo1 | cle1 | cdg1 | fra1 | arn1 | sin1 | pdx1 | lhr1 | icn1 | bom1 | cpt1 | dub1 | gru1 | hkg1 | syd1 | yul1 | hnd1 | kix1 | The Vercel region in which to create the sandbox. |
failoverRegions | array | The regions the sandbox falls back to when it cannot be created in region. |
networkId | string | The Connect network id for the target Secure Compute private network. |
name | string | Name for the sandbox. Must be unique per project and URL-safe (alphanumeric… |
persistent | boolean | Whether the sandbox persists its state across restarts via automatic… |
snapshotExpiration | string | Default snapshot expiration time in milliseconds. Defaults to 7 days. Set to 0… |
keepLastSnapshots | object | Protect the N most recent snapshots with different expiration/deletion… |
tags | object | Key-value tags to associate with the sandbox. Maximum 5 tags. |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "vercel_api__create_sandboxes_v4",
"arguments": {}
}Or connect the Vercel API server directly, which lists 472 tools including this one:
claude mcp add --transport http hj-vercel-api https://mcp.hjlabs.in/mcp/vercel-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the create a named sandbox tool with teamId set to ….