Skip to main content
The ultra install command configures your MCP clients (Claude Desktop, Cursor, VS Code, Claude Code, Goose) to route traffic through Ultra.

​
Interactive Wizard

Run the install wizard to be guided through the process: 
ultra install
The wizard detects installed MCP clients, lets you choose which ones to configure, and sets Ultra as the MCP server in each client’s configuration.

​
Non-Interactive Mode

Install into a specific client: 
# Claude Desktop
ultra install --client claude

# Cursor
ultra install --client cursor

# Skip confirmation
ultra install --client claude --yes
Install into all detected clients: 
ultra install --yes

​
List Detected Clients

Preview which clients Ultra can detect without making changes: 
ultra install --list
This shows each client’s installation status, config path, and any existing MCP server configurations.

​
Supported Clients

ClientFlag ValueConfig Location
Claude DesktopclaudePlatform-specific (see below)
Cursorcursor~/.cursor/mcp.json
VS CodevscodeVS Code settings
Claude Codeclaude_code~/.claude/
Goosegoose~/.config/goose/

​
Claude Desktop Config Paths

PlatformPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

​
What It Does

When you run ultra install, it writes Ultra as an MCP server entry in the client’s configuration file. For example, Claude Desktop’s config will look like: 
{
  "mcpServers": {
    "ultra": {
      "command": "/usr/local/bin/ultra",
      "args": ["start"]
    }
  }
}
The client then launches Ultra via ultra start whenever it needs MCP tools. Ultra in turn connects to your configured upstream servers.

​
Flags

FlagShortDefaultDescription
--client-cTarget client (claude, cursor)
--configPath to Ultra config file
--no-backupfalseSkip backup of existing config
--yes-yfalseSkip confirmation prompt
--list-lfalseList detected clients

​
After Installation

  1. Restart your MCP client to load Ultra
  2. Run ultra migrate to import existing MCP servers into Ultra’s config
  3. Or add new servers with ultra search and ultra add