ultra servers

Manage configured MCP servers

List, add, remove, enable, and disable upstream MCP servers.

Usage

ultra servers [subcommand] [flags]

Running ultra servers without a subcommand lists all configured servers.

Subcommands

list (default)

List all configured servers with status, transport info, and description.

ultra servers
ultra servers list
ultra servers ls

add

Add a new MCP server manually.

ultra servers add <name> [flags]

Flag	Short	Default	Description
--command			Command to execute (stdio transport)
--args			Command arguments (space-separated)
--url			Server URL (HTTP transport)
--description	-d		Server description
--env	-e		Environment variables (KEY=VALUE, repeatable)
--disabled		false	Add in disabled state

# Stdio server
ultra servers add filesystem \
  --command npx \
  --args "-y @modelcontextprotocol/server-filesystem /tmp"

# HTTP server
ultra servers add remote-api --url https://mcp.example.com/sse

# With environment variables
ultra servers add github \
  --command npx \
  --args "-y @modelcontextprotocol/server-github" \
  --env "GITHUB_TOKEN=ghp_xxx"

# Disabled initially
ultra servers add test-server --command ./test-server --disabled

remove

Remove a server from configuration.

ultra servers remove <name> [flags]

Flag	Short	Default	Description
--force	-f	false	Skip confirmation prompt

Aliases: rm, delete

enable

Enable a disabled server.

ultra servers enable <name>

disable

Disable a server without removing it.

ultra servers disable <name>

Examples

# List all configured servers
ultra servers

# Add a server manually
ultra servers add filesystem --command npx --args "-y @modelcontextprotocol/server-filesystem /tmp"

# Remove a server
ultra servers remove filesystem

# Enable/disable a server
ultra servers enable filesystem
ultra servers disable filesystem

For adding servers from registries, use ultra add instead — it handles registry lookup, configuration prompts, and connection testing automatically.