Skip to main content
The ultra migrate command discovers MCP servers already configured in your clients (Claude Desktop, Cursor) and imports them into Ultra’s configuration.

​
Interactive Wizard

Run the migration wizard: 
ultra migrate
The wizard scans your MCP clients for configured servers, shows what it found, and lets you choose which ones to import.

​
Non-Interactive Mode

# Migrate all discovered servers
ultra migrate --yes

# Migrate from a specific client only
ultra migrate --from claude --yes

​
Preview Changes

See what would happen without making any changes: 
# List discovered servers
ultra migrate --list

# Dry run — preview the Ultra config that would be generated
ultra migrate --dry-run

​
How It Works

  1. Discovery — Scans Claude Desktop and Cursor config files for MCP server entries
  2. Deduplication — Detects servers configured in multiple clients and merges them
  3. Validation — Warns about potential issues (missing commands, invalid configs)
  4. Import — Writes discovered servers to Ultra’s config as upstream entries
  5. Client Update — Updates client configs to point to Ultra instead of individual servers
After migration, your clients connect to Ultra, and Ultra connects to all your upstream servers. This gives you observability over all MCP traffic without changing your workflow.

​
Flags

FlagShortDefaultDescription
--configPath to Ultra config file
--yes-yfalseSkip confirmation prompt
--list-lfalseList discovered MCP servers
--dry-runfalsePreview changes without applying
--fromMigrate from specific client only (claude, cursor)

​
After Migration

  1. Restart your MCP client(s) to route traffic through Ultra
  2. Run ultra start to start the proxy
  3. Run ultra dashboard to view traces