> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ultra.security/llms.txt
> Use this file to discover all available pages before exploring further.

# ultra servers

> Manage configured MCP servers

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

## Usage

```bash theme={null}
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.

```bash theme={null}
ultra servers
ultra servers list
ultra servers ls
```

### `add`

Add a new MCP server manually.

```bash theme={null}
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                           |

```bash theme={null}
# 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.

```bash theme={null}
ultra servers remove <name> [flags]
```

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

Aliases: `rm`, `delete`

### `enable`

Enable a disabled server.

```bash theme={null}
ultra servers enable <name>
```

### `disable`

Disable a server without removing it.

```bash theme={null}
ultra servers disable <name>
```

<Tip>
  To re-authenticate an OAuth server whose sign-in has expired, use the top-level [`ultra reconnect`](/cli/reconnect) command.
</Tip>

## Examples

```bash theme={null}
# 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
```

<Tip>
  For adding servers from registries, use [`ultra add`](/cli/add) instead — it handles registry lookup, configuration prompts, and connection testing automatically.
</Tip>