Skip to main content
Discover MCP servers configured in your clients and import them into Ultra’s configuration.

Usage

ultra migrate [flags]

Flags

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

Examples

# Interactive migration wizard
ultra migrate

# List discovered MCP servers without migrating
ultra migrate --list

# Dry run to preview changes
ultra migrate --dry-run

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

# Non-interactive migration
ultra migrate --yes

How It Works

  1. Scans Claude Desktop and Cursor config files for MCP server entries
  2. Deduplicates servers found in multiple clients
  3. Validates server configurations and warns about issues
  4. Writes discovered servers to Ultra’s config as upstream entries
  5. Updates client configs to point to Ultra

Dry Run

The --dry-run flag shows exactly what Ultra config would be generated without making any changes. Useful for reviewing the migration before committing.