MCP Tools Reference
Complete reference for all tools available in the Conway MCP server.
The Conway MCP server provides the following tools for AI agents.
Sandbox Tools
sandbox_create
Create a new cloud sandbox.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
name | string | No | Optional name for the sandbox |
vcpu | number | No | Number of vCPUs (1-4, default: 1) |
memory_mb | number | No | Memory in MB (512-8192, default: 512) |
disk_gb | number | No | Disk size in GB (1-50, default: 1) |
region | string | No | Region: "eu-north" or "us-east" (default: eu-north) |
Returns: Sandbox ID, terminal URL, and resource allocation.
sandbox_list
List all sandboxes with their IDs, names, and status.
Parameters: None
Returns: Array of sandbox objects with ID, name, status, resources, and region.
sandbox_exec
Execute a shell command in a sandbox.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID (32 hex characters) |
command | string | Yes | Shell command to execute |
timeout | number | No | Timeout in seconds (default: 30) |
Returns: stdout, stderr, and exit code.
sandbox_write_file
Write a file to a sandbox.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID |
path | string | Yes | Absolute path (e.g., /root/script.py) |
content | string | Yes | File content |
Returns: Status, path, and file size.
sandbox_read_file
Read a file from a sandbox.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID |
path | string | Yes | Absolute path to read |
Returns: File content as string.
sandbox_expose_port
Expose a port from a sandbox to get a public URL.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID |
port | number | Yes | Port number (1-65535) |
Returns: Port number and public URL.
sandbox_delete
Delete a sandbox.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID to delete |
Returns: Success confirmation.
sandbox_get_url
Get the public URL for a specific port on a sandbox.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID |
port | number | Yes | Port number |
Returns: Public URL in format https://{port}-{sandbox_id}.life.conway.tech
PTY Tools
sandbox_pty_create
Create a new PTY (pseudo-terminal) session for interactive programs.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID |
command | string | Yes | Command to run (e.g., "bash", "python3") |
cols | number | No | Terminal columns (default: 80) |
rows | number | No | Terminal rows (default: 24) |
Returns: Session ID, command, dimensions, state, and creation time.
sandbox_pty_write
Write input to a PTY session.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID |
session_id | string | Yes | PTY session ID |
input | string | Yes | Input to send (use \n for Enter) |
Returns: Success status and bytes written.
sandbox_pty_read
Read output from a PTY session.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID |
session_id | string | Yes | PTY session ID |
full | boolean | No | Return full scrollback buffer (default: false) |
Returns: Terminal output, state, and dimensions.
sandbox_pty_close
Close a PTY session and terminate the process.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID |
session_id | string | Yes | PTY session ID to close |
Returns: Success status and final state.
sandbox_pty_list
List all active PTY sessions for a sandbox.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
sandbox_id | string | Yes | Full sandbox ID |
Returns: Array of active sessions with command, state, and creation time.
Inference Tools
chat_completions
Send a chat completion request to an OpenAI model, billed from Conway credits.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
model | string | Yes | OpenAI model name (e.g., "gpt-4o-mini", "gpt-4o", "o3-mini") |
messages | array | Yes | Array of message objects with role and content |
temperature | number | No | Sampling temperature (0-2, default: 1) |
max_tokens | number | No | Maximum tokens to generate |
Returns: Model response with content, finish reason, and token usage.
x402 Payment Tools
wallet_info
Get information about the x402 payment wallet.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
network | string | No | Network ID (default: eip155:8453 for Base) |
Returns: Wallet address, USDC balance, and deposit link.
wallet_networks
List all supported networks for x402 payments.
Parameters: None
Returns: Array of supported networks with chain IDs and USDC addresses.
x402_discover
Discover x402 endpoints for a given URL.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Origin URL to discover resources from |
Returns: Discovered x402 endpoints and payment requirements.
x402_check
Check if a URL requires x402 payment.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Endpoint URL to check |
method | string | No | HTTP method (default: GET) |
Returns: Payment requirements if 402 response.
x402_fetch
Fetch a URL with automatic x402 payment handling.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Endpoint URL to fetch |
method | string | No | HTTP method (default: GET) |
headers | object | No | Additional headers |
body | string | No | Request body for POST/PUT/PATCH |
Returns: Response data with automatic payment if required.