Skip to main content
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]
FlagShortDefaultDescription
--commandCommand to execute (stdio transport)
--argsCommand arguments (space-separated)
--urlServer URL (HTTP transport)
--description-dServer description
--env-eEnvironment variables (KEY=VALUE, repeatable)
--disabledfalseAdd 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]
FlagShortDefaultDescription
--force-ffalseSkip 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.