Vast.ai MCP Server

An MCP (Model Context Protocol) server that exposes Vast.ai cloud operations as tools: list GPUs, search offers, create volumes, create instances, and view billing.

Setup

Installed as a package via pip (recommended):

pip install vastai-mcp
export VAST_API_KEY=your_api_key_here

Or from source, for local development:

pip install -e .

Get an API key at https://cloud.vast.ai (Settings -> API Keys).

Run (stdio, for MCP clients)

Installing the package puts a vastai-mcp command on your PATH:

vastai-mcp

Claude Desktop config example

{
  "mcpServers": {
    "vastai": {
      "command": "vastai-mcp",
      "env": { "VAST_API_KEY": "your_api_key" }
    }
  }
}

(See mcp.json.example in this repo for a copy-pasteable template — copy it to mcp.json and fill in your key; mcp.json itself is gitignored since it holds a real secret.)

Tools

Typical workflow

1. search_offers(gpu_name="RTX 4090", max_price=1.0, limit=10) to find a machine.
2. billing_summary to check current spend.
3. create_instance(offer_id=123, max_hourly_price=1.0, volume={"size_gb": 100, "mount_path": "/data"}) to launch (refuses if the offer's live price exceeds max_hourly_price).
4. destroy_instance(instance_id=...) / delete_volume(volume_id=...) to tear down when done.