VESSL Cloud Documentation

There are two complementary ways to connect VESSL Cloud to AI coding tools. Install the vesslctl skill so your agent can create workspaces, submit jobs, and manage volumes on your behalf. Connect the MCP server so your agent can look up commands, flags, and workflows directly from the docs while you work.

Install the vesslctl skill

The vesslctl skill command installs a bundled skill file that teaches AI coding agents (such as Claude Code, Codex, Gemini CLI, and Cursor) how to operate VESSL Cloud through vesslctl. Skills follow the Agent Skills open standard. Run it interactively and pick a target:

vesslctl skill install

Available targets:

Target	Default directory	Works with
`cross-client`	`~/.agents/skills`	Codex, Gemini CLI, Cursor, and other Agent-Skills-compatible agents
`claude-code`	`~/.claude/skills`	Claude Code (native)

Non-interactive install:

vesslctl skill install --target claude-code
vesslctl skill install --target cross-client
vesslctl skill install --dir ~/my-skills

The command is idempotent — re-running it skips files that are already up to date. Once the skill is installed, the agent can act on VESSL Cloud without any further prompting. Try:

Create a GPU workspace on VESSL Cloud

For the full flag reference and the skill show subcommand, see vesslctl skill.

Connect the docs through MCP

Give your AI tool live access to VESSL Cloud docs so it can look up commands, flags, and workflows while you work. Connect this URL to any MCP-compatible AI tool:

https://docs.cloud.vessl.ai/mcp

The server exposes two tools:

Tool	Description
`search_vessl_ai`	Search across all VESSL Cloud documentation for relevant content
`query_docs_filesystem_vessl_ai`	Run shell-like commands (`rg`, `grep`, `cat`, `head`, `tree`, `ls`) on a virtual filesystem of VESSL Cloud docs to inspect structure and read specific pages

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`

Cursor

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

Windsurf

Open Settings
Navigate to Cascade > MCP
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

Per-page MCP links

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.

Get started

Examples

vesslctl CLI

Use VESSL Cloud

Operate organization

VM Clusters

Glossary

Support

Use with AI tools

Install the vesslctl skill

Connect the docs through MCP

Claude Code

Example CLAUDE.md for `vesslctl` projects

Cursor

Windsurf

VS Code (with Copilot or Continue)

Other tools

Per-page MCP links

​Install the vesslctl skill

​Connect the docs through MCP

​Claude Code

​Example CLAUDE.md for vesslctl projects

​Cursor

​Windsurf

​VS Code (with Copilot or Continue)

​Other tools

​Per-page MCP links

Install the vesslctl skill

Connect the docs through MCP

Claude Code

Example CLAUDE.md for `vesslctl` projects

Cursor

Windsurf

VS Code (with Copilot or Continue)

Other tools

Per-page MCP links