ultra add - Ultra

Add an MCP connector from the official MCP Registry, npm, or a remote URL.

Usage

ultra add <connector|url> [flags]

Arguments

Argument	Required	Description
`connector` or `url`	Yes	Connector name/package or HTTP(S) URL

Flags

Flag	Short	Default	Description
`--name`		Derived from package	Custom name for the connector
`--disabled`		`false`	Add connector in disabled state
`--yes`	`-y`	`false`	Accept defaults without prompting

Examples

# Add the official filesystem connector
ultra add @modelcontextprotocol/server-filesystem

# Add by short name (searches registries)
ultra add filesystem

# Add with a custom name
ultra add @modelcontextprotocol/server-filesystem --name myfiles

# Add without prompts (use defaults)
ultra add filesystem --yes

# Add a remote connector by URL
ultra add https://mcp.slack.com/mcp

# Add a remote connector with a custom name
ultra add https://remote.example.com/mcp --name myconnector

Registry Lookup

When you pass a package name:

Full name (contains / or starts with @) — Direct lookup in registries
Short name — Searches registries and presents matching results for selection

If multiple results are found, Ultra shows an interactive selector (up to 9 results).

URL Mode

When you pass an HTTP(S) URL:

Ultra derives a connector name from the hostname (e.g., https://mcp.slack.com → slack)
Tests the connection and detects authentication requirements
For OAuth connectors, authorization happens at runtime
For token-based auth, prompts for the token during setup

Connection Testing

For both registry and URL connectors, Ultra tests the connection:

Stdio connectors — Probes the connector with the MCP handshake. If the default args fail, automatically tries common fixes (e.g., appending --stdio)
HTTP connectors — Tests connectivity and detects auth requirements (OAuth, Bearer token, API key)

Configuration

Added connectors are written to Ultra’s config file. Environment variables and auth tokens are collected during the interactive flow or can be set later:

ultra config set-token my-connector YOUR_TOKEN

​Usage

​Arguments

​Flags

​Examples

​Registry Lookup

​URL Mode

​Connection Testing

​Configuration