Skip to main content
VESSL Cloud documentation is available as an MCP (Model Context Protocol) server. AI coding assistants can search and read the docs directly, giving them accurate context about vesslctl commands, flags, and workflows.

MCP server

Connect this URL to any MCP-compatible AI tool:
https://docs.cloud.vessl.ai/mcp
The server exposes two tools:
ToolDescription
search_vessl_aiSearch across all VESSL Cloud documentation for relevant content
query_docs_filesystem_vessl_aiRun shell-like commands (rg, grep, cat, head, tree, ls) on a virtual filesystem of VESSL Cloud docs to inspect structure and read specific pages

Set up with Claude Code

Add the MCP server to your project’s CLAUDE.md or Claude Code settings:
{
  "mcpServers": {
    "vessl-docs": {
      "type": "url",
      "url": "https://docs.cloud.vessl.ai/mcp"
    }
  }
}
Once connected, Claude Code can look up vesslctl commands, check available flags, and reference common workflows while helping you write scripts or debug issues.

Example CLAUDE.md for vesslctl projects

# Project Setup

This project uses VESSL Cloud for GPU workloads.

## Tools
- `vesslctl` CLI for managing workspaces and batch jobs
- VESSL docs available through MCP at https://docs.cloud.vessl.ai/mcp

## Common tasks
- Create workspace: `vesslctl workspace create --name <name> --resource-spec <spec> --image <image>`
- Submit batch job: `vesslctl job create --name <name> --resource-spec <spec> --image <image> --cmd "<command>"`
- Check job logs: `vesslctl job logs <slug> --follow`

Set up with AI-powered IDEs

MCP setup varies by IDE. Here are the most common ones:

Cursor

  1. Open Settings
  2. Go to MCP Servers
  3. Add a new server with URL: https://docs.cloud.vessl.ai/mcp

Windsurf

  1. Open Settings
  2. Navigate to Cascade > MCP
  3. Add a new MCP server with URL: https://docs.cloud.vessl.ai/mcp

VS Code (with Copilot or Continue)

Add to your .vscode/mcp.json:
{
  "servers": {
    "vessl-docs": {
      "type": "url",
      "url": "https://docs.cloud.vessl.ai/mcp"
    }
  }
}

Other tools

Any tool that supports MCP can connect using the server URL. Check your tool’s documentation for how to add an MCP server, then use:
https://docs.cloud.vessl.ai/mcp
Each page in the VESSL Cloud docs has a Copy MCP link option in the context menu. Use this to share a direct MCP reference to a specific page with your AI tool.