ultra add - Ultra

Add a connector by name and the exact local command or remote URL. ultra search only lists connectors. It does not install one.

Usage

ultra add [options] <name> <command-or-url> [args...]

Put -- before any command argument that starts with a dash, so Ultra does not read it as its own flag.

Arguments

Argument	Required	Description
`name`	Yes	Connector name, unique in this config. Starts with a letter or digit, then only letters, digits, `.`, `_`, or `-`. 64 characters maximum.
`command-or-url`	Yes	Local command, or an `http://` or `https://` URL
`args`	No	Arguments to a local command

Flags

Flag	Short	Default	Applies to	Description
`--transport`	`-t`	`stdio`	Any	`stdio`, `http` (Streamable HTTP), or `sse`
`--env`	`-e`		`stdio`	Environment variable, as `KEY=VALUE`. Repeatable.
`--header`	`-H`		`http`, `sse`	HTTP header, as `Name: Value`. Repeatable.
`--client-id`			`http`, `sse`	OAuth client ID for a connector that does not register clients itself
`--client-secret`		`false`	`http`, `sse`	Prompt for an OAuth client secret, or read `MCP_CLIENT_SECRET`. Requires `--client-id`.
`--callback-port`		`0`	`http`, `sse`	Local port for the OAuth callback. `0` lets the OS choose a port.
`--disabled`		`false`	Any	Add the connector disabled
`--config`	`-c`		Any	Path to the Ultra config file

Ultra rejects environment variables that can change how a process starts, such as PATH and HOME.

Examples

# Local stdio connector. Arguments after -- are passed to npx.
ultra add filesystem -- npx -y @modelcontextprotocol/server-filesystem /tmp

# Pass environment variables through to a local command. Repeat --env for each one.
ultra add --env API_TOKEN="$API_TOKEN" myserver -- ./myserver

# Streamable HTTP connector. Sign-in runs after the entry is saved.
ultra add --transport http notion https://mcp.notion.com/mcp

# SSE connector with a bearer token. The Authorization header skips browser sign-in.
ultra add --transport sse --header "Authorization: Bearer $MCP_API_TOKEN" legacy https://example.com/events

# Remote connector that needs a pre-registered OAuth client.
# --client-secret prompts, or reads MCP_CLIENT_SECRET when that variable is set.
ultra add --transport http --client-id "$SLACK_CLIENT_ID" --client-secret slack https://mcp.slack.com/mcp

Local connectors

The default transport is stdio. The second argument is the program to run, and anything after it is that program’s arguments. A URL is not a stdio target. Pass --transport http or --transport sse when the second argument is a URL.

Remote connectors

--transport http selects Streamable HTTP. --transport sse selects SSE. Remote transports do not take command arguments. The URL must be http or https, include a host, and must not contain a username, password, or fragment. Put credentials in --header instead. An http:// URL whose host is not loopback prints a warning: traffic and credentials are not encrypted. An enabled remote connector is saved before Ultra checks whether browser sign-in is required. The check is skipped when:

the connector was added with --disabled
an Authorization header was set with --header
the URL contains query parameters

When sign-in is required, Ultra prints a link and opens a browser. Ctrl+C cancels sign-in and leaves the connector configured. If sign-in fails, the connector stays configured. Run ultra reconnect <name> to try again. A connector that does not ask for browser sign-in is left as configured. --client-secret reads MCP_CLIENT_SECRET when it is set. Otherwise it prompts on a terminal and does not put the secret in shell history. A non-interactive shell with no MCP_CLIENT_SECRET fails.

After adding

The entry is written to the config file immediately. Restart your agent to use the new connector. If your organization blocks that connector, ultra add stops before it writes the config. ultra connectors add writes an entry from --command or --url and does not start sign-in. Use it when you want that flag form, including a description. Use ultra config set-token to attach a bearer token after the connector exists.

​Usage

​Arguments

​Flags

​Examples

​Local connectors

​Remote connectors

​After adding