---
description: "Run the Verda CLI MCP server so that AI assistants and agents can inspect and manage your GPU instances, containers, and storage through ordinary tool calls."
revision_date: 04.08.2026
---

# MCP Server

!!! info
    This feature is in **beta** — feedback is welcome.

The Verda CLI includes a built-in [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that lets AI agents manage your Verda infrastructure through natural language. Once configured, you can ask your agent to provision instances, check costs, and manage resources without running commands manually.

***

#### Setup

Add the following to your agent's MCP configuration:

```json
{
  "mcpServers": {
    "verda": {
      "command": "verda",
      "args": ["mcp", "serve"]
    }
  }
}
```

| Agent | Config file |
|-------|------------|
| Claude Code | `.mcp.json` in project root |
| Cursor | `~/.cursor/mcp.json` |

Credentials are shared with the CLI — run `verda auth login` first.

***

#### Usage

Once configured, just talk to your agent:

```
"What GPU types are available right now?"
"How much does an 8x H100 cost per hour?"
"I need a cheap GPU for testing — what's the best option?"
"Deploy a V100 GPU VM with 100GB OS volume"
"Show my running VMs and what they're costing me"
"Shut down my training VM"
```

***

#### Available tools

The MCP server exposes 18 tools organized by category:

**Discovery**

* `list_locations` — list available datacenters
* `list_instance_types` — list instance types with specs and pricing
* `check_availability` — check instance availability by location
* `list_images` — list OS images

**VM management**

* `list_vms` — list VM instances
* `describe_vm` — get details about a single VM
* `create_vm` — create a new VM
* `vm_availability` — check instance type availability
* `vm_action` — start, shutdown, force shutdown, hibernate, or delete a VM

**Cost and billing**

* `estimate_cost` — estimate costs for an instance configuration
* `get_balance` — get account balance
* `get_running_costs` — get current running costs

**SSH keys**

* `add_ssh_key` — add an SSH public key
* `list_ssh_keys` — list SSH keys
* `get_ssh_command` — get the SSH command to connect to a VM

**Storage**

* `create_volume` — create a storage volume
* `list_volumes` — list volumes
* `list_volumes_in_trash` — list volumes in trash

***

#### Agent mode

For scripts and agents that use the CLI directly without MCP:

```bash
verda --agent vm list                  # JSON output, no prompts
verda --agent vm create ...            # structured errors for missing flags
verda --agent vm action --id X --action shutdown --yes
```

Agent mode outputs JSON and returns structured errors, making it easy to parse programmatically.