← Back to docs

MCP Tools Reference

Tools available through the Volspan MCP server.

run_on_gpu

Submit Python code to execute on a GPU. Returns a run ID for tracking.

code (string, required)

Python code to execute.

gpu (string, optional)

GPU tier. Options: A40, A100, H100. Default: A100.

timeout (integer, optional)

Max execution time in seconds. Default: 300. Max: 3600.

packages (string[], optional)

Additional pip packages to install before execution.

check_vault_balance

Check the current vault balance for the authenticated workspace.

No parameters required.

Returns balance_cents, reserved_cents, and available_cents.

get_gpu_run

Get the status and results of a specific GPU run.

run_id (string, required)

The run ID returned by run_on_gpu.

Returns status, stdout, stderr, duration, and cost.

list_gpu_runs

List recent GPU runs with optional filters.

limit (integer, optional)

Number of runs to return. Default: 10. Max: 100.

status (string, optional)

Filter by status: queued, running, completed, failed.

gpu (string, optional)

Filter by GPU tier.

Need help? Reach out at [email protected]