unsandbox

remote code execution

62 tools2 likes2 forks

MCP Server URLs

HTTP Transport(recommended)
https://tpmjs.com/api/mcp/ajax/unsandbox/http
SSE Transport(streaming)
https://tpmjs.com/api/mcp/ajax/unsandbox/sse

You'll need to provide your own API keys for any tools that require them. Pass credentials via the env parameter in your API calls.

Use these URLs with Claude Desktop, Cursor, or any MCP client

Tools in Collection

deleteJob

Cancel a pending or running code execution job. Returns any partial output and compiled artifacts. Cancellation is best-effort - jobs may complete before cancellation takes effect.

sandbox
@tpmjs/tools-unsandbox
0

healthCheck

Check the health status of the Unsandbox API service.

sandbox
@tpmjs/tools-unsandbox
0

deleteSnapshot

Permanently delete a snapshot.

sandbox
@tpmjs/tools-unsandbox
0

unfreezeService

Manually wake a frozen service.

sandbox
@tpmjs/tools-unsandbox
0

deleteSession

Terminate and destroy a session permanently.

sandbox
@tpmjs/tools-unsandbox
0

getSnapshot

Get detailed information about a snapshot.

sandbox
@tpmjs/tools-unsandbox
0

getImage

Get detailed information about an image.

sandbox
@tpmjs/tools-unsandbox
0

lockSession

Lock a session to prevent accidental deletion.

sandbox
@tpmjs/tools-unsandbox
0

unlockSession

Unlock a locked session to allow deletion.

sandbox
@tpmjs/tools-unsandbox
0

lockService

Lock a service to prevent accidental deletion.

sandbox
@tpmjs/tools-unsandbox
0

unlockService

Unlock a locked service to allow deletion.

sandbox
@tpmjs/tools-unsandbox
0

deleteService

Permanently destroy a service and its container.

sandbox
@tpmjs/tools-unsandbox
0

lockSnapshot

Lock a snapshot to prevent accidental deletion.

sandbox
@tpmjs/tools-unsandbox
0

unlockSnapshot

Unlock a locked snapshot to allow deletion.

sandbox
@tpmjs/tools-unsandbox
0

lockImage

Lock an image to prevent accidental deletion.

sandbox
@tpmjs/tools-unsandbox
0

unlockImage

Unlock a locked image to allow deletion.

sandbox
@tpmjs/tools-unsandbox
0

unfreezeSession

Wake a frozen session and restore its state.

sandbox
@tpmjs/tools-unsandbox
0

restoreSession

Restore a session to a previous snapshot state.

sandbox
@tpmjs/tools-unsandbox
0

listServices

List all services with optional filtering by status.

sandbox
@tpmjs/tools-unsandbox
0

deleteServiceEnv

Remove specific environment variables from the service.

sandbox
@tpmjs/tools-unsandbox
0

getService

Get detailed service information including state, ports, and URL.

sandbox
@tpmjs/tools-unsandbox
0

executeInService

Run a command inside a running service container.

sandbox
@tpmjs/tools-unsandbox
0

getServiceLogs

Get bootstrap and application logs for the service.

sandbox
@tpmjs/tools-unsandbox
0

getServiceEnv

Retrieve all environment variables set for the service.

sandbox
@tpmjs/tools-unsandbox
0

setServiceEnv

Set or update environment variables for the service.

sandbox
@tpmjs/tools-unsandbox
0

createSnapshot

Create a snapshot from an existing session or service.

sandbox
@tpmjs/tools-unsandbox
0

listSnapshots

List all snapshots with optional filtering by source type.

sandbox
@tpmjs/tools-unsandbox
0

cloneSnapshot

Create a new session or service from a snapshot.

sandbox
@tpmjs/tools-unsandbox
0

revokeImageAccess

Revoke previously granted access from an API key.

sandbox
@tpmjs/tools-unsandbox
0

listJobs

List all active code execution jobs with their current status.

sandbox
@tpmjs/tools-unsandbox
0

createSessionSnapshot

Create a snapshot of the session's container state.

sandbox
@tpmjs/tools-unsandbox
0

redeployService

Re-run the bootstrap script. Optionally provide new bootstrap content.

sandbox
@tpmjs/tools-unsandbox
0

createServiceSnapshot

Create a snapshot of the service's container state.

sandbox
@tpmjs/tools-unsandbox
0

restoreSnapshot

Restore a snapshot to its original source (session or service).

sandbox
@tpmjs/tools-unsandbox
0

listImages

List all images with optional filtering by visibility and ownership.

sandbox
@tpmjs/tools-unsandbox
0

getSystemStats

Get system statistics including resource utilization and job metrics.

sandbox
@tpmjs/tools-unsandbox
0

listPools

List available execution pools with their configurations and current status.

sandbox
@tpmjs/tools-unsandbox
0

getSession

Get detailed session information including status, shell, and WebSocket URL.

sandbox
@tpmjs/tools-unsandbox
0

listSessions

List all sessions with optional filtering by status (active, frozen, locked).

sandbox
@tpmjs/tools-unsandbox
0

spawnFromImage

Create a new service using this image as the base.

sandbox
@tpmjs/tools-unsandbox
0

executeInSession

Run a command inside a session's container and return output.

sandbox
@tpmjs/tools-unsandbox
0

freezeService

Freeze a service to save resources. Auto-unfreezes on first HTTP request.

sandbox
@tpmjs/tools-unsandbox
0

getClusterStatus

Get status of the execution cluster including node availability and capacity.

sandbox
@tpmjs/tools-unsandbox
0

deleteImage

Permanently delete an image from LXD and the database. Cannot delete locked images.

sandbox
@tpmjs/tools-unsandbox
0

getShells

Get list of available shell interpreters (bash, zsh, etc.) with their versions and capabilities.

sandbox
@tpmjs/tools-unsandbox
0

getImageTrustedKeys

List all API keys that have been granted access to this image.

sandbox
@tpmjs/tools-unsandbox
0

getLanguages

Get list of all supported programming languages with their metadata including extensions, version, and capabilities.

sandbox
@tpmjs/tools-unsandbox
0

freezeSession

Freeze a session to save resources. Container state is preserved and can be woken later.

sandbox
@tpmjs/tools-unsandbox
0

transferImage

Transfer full ownership of an image to another API key. The image stays on the same LXD node.

sandbox
@tpmjs/tools-unsandbox
0

createSession

Create a persistent interactive shell session with WebSocket access. Sessions persist between commands and can be frozen/unfrozen.

sandbox
@tpmjs/tools-unsandbox
0

run

Execute code with automatic language detection. Uses shebang lines (e.g., #!/usr/bin/env python), syntax patterns, and heuristics for detection.

sandbox
@tpmjs/tools-unsandbox
0

runAsync

Execute code asynchronously with automatic language detection. Returns a job_id immediately. Use getJob to check status and retrieve results.

sandbox
@tpmjs/tools-unsandbox
0

createService

Create a long-running service with custom subdomain. Services persist until explicitly destroyed and can auto-unfreeze on HTTP requests.

sandbox
@tpmjs/tools-unsandbox
0

execute

Execute code synchronously in a secure sandbox. Blocks until execution completes and returns results directly. Best for quick scripts under 60 seconds.

sandbox
@tpmjs/tools-unsandbox
0

publishImage

Create an independent LXD image from a service or snapshot. Images survive container deletion and can be transferred between API keys.

sandbox
@tpmjs/tools-unsandbox
0

setImageVisibility

Control who can see and use this image. Options: private (only owner), unlisted (shareable via trust), public (visible to all).

sandbox
@tpmjs/tools-unsandbox
0

getJob

Get the status and results of an async code execution job. Poll this endpoint until status is 'completed', 'failed', 'cancelled', or 'timeout'.

sandbox
@tpmjs/tools-unsandbox
0

grantImageAccess

Grant access to a private/unlisted image for a specific API key. The granted user can use the image to spawn services.

sandbox
@tpmjs/tools-unsandbox
0

executeCodeAsync

Execute code asynchronously in a secure sandbox. Returns a job_id immediately. Use getJob to check status and retrieve results. Supports 42+ languages including Python, JavaScript, TypeScript, Go, Rust, C, C++, Java, Ruby, and more.

sandbox
@tpmjs/tools-unsandbox
0

base64EncodeTool

Encode string or buffer to base64 format. Supports utf8 (default), binary, and hex character encodings. Returns the base64 encoded string and the byte length of the original data.

data
@tpmjs/official-base64-encode
0

searchTool

Search the web and optionally scrape content from search results. Best for: Finding information across multiple websites when you don't know the exact URL. Supports search operators: site:, inurl:, intitle:, related:, etc. Example use cases: - Find the latest news about a topic - Search for specific information across multiple sources - Discover content related to a query

search
firecrawl-aisdk
0

perplexitySearch

Search the web using Perplexity's Search API for real-time information, news, research papers, and articles. Provides ranked search results with advanced filtering options including domain, language, date range, and recency filters.

search
@perplexity-ai/ai-sdk
0

Example Use Cases

Example prompt:

Is the Unsandbox remote code execution service running properly right now?

Verify the health status of the Unsandbox API to ensure it is operational and ready for use.

Tool workflow:

1.healthCheck

Example prompt:

Run the command 'ls -la' inside my active session and show me the output.

Execute a shell command inside an existing session container and return its output.

Tool workflow:

1.executeInSession

Example prompt:

Delete a snapshot that I no longer need, even if it's currently locked.

Unlock a locked snapshot first and then delete it permanently to free resources.

Tool workflow:

1.unlockSnapshot
2.deleteSnapshot

Example prompt:

Update environment variables for my running service, check its logs afterward to confirm changes.

Retrieve current environment vars, update them, then fetch service logs to verify environment changes.

Tool workflow:

1.getServiceEnv
2.setServiceEnv
3.getServiceLogs

Example prompt:

Create a snapshot of my session, then restore my session to it, and finally clone that snapshot as a new session.

Create a snapshot from a session, restore the session state from it, and clone the snapshot to spawn a new identical session.

Tool workflow:

1.createSessionSnapshot
2.restoreSession
3.cloneSnapshot

Example prompt:

List all services, identify one frozen service, unfreeze it, lock it to prevent deletion, then redeploy it with a new bootstrap script.

Comprehensively manage services by listing, unfreezing frozen ones, locking to protect, and redeploying with updated bootstrap content.

Tool workflow:

1.listServices
2.unfreezeService
3.lockService
4.redeployService

Generated 1/16/2026

Test Scenarios