Skip to main content
Detect installed MCP clients and configure them to use Ultra as their MCP server.

​
Usage

ultra install [flags]

​
Flags

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

​
Examples

# Interactive installation wizard
ultra install

# Install into Claude Desktop only
ultra install --client claude

# Install into Cursor only
ultra install --client cursor

# Install into Codex only
ultra install --client codex

# List detected clients without installing
ultra install --list

# Non-interactive installation to all detected clients
ultra install --yes

​
Supported Clients

ClientFlag ValueAliases
Claude Desktopclaudeclaude-desktop, claude_desktop
Cursorcursor
Codexcodexcodex-cli

​
What It Does

The install command writes Ultra as an MCP server entry in the client’s configuration. For example, Claude Desktop’s config becomes: 
{
  "mcpServers": {
    "ultra": {
      "command": "/usr/local/bin/ultra",
      "args": ["start"]
    }
  }
}
For Codex, the TOML config at ~/.codex/config.toml becomes: 
[mcp_servers.ultra]
command = "/usr/local/bin/ultra"
args = ["start"]
If --config is specified, the args include --config <path>.

​
Backups

By default, the existing client config is backed up before modification. Use --no-backup to skip.