everruns mcp-servers

Registered MCP servers available to agents and sessions.

Command	What it does
mcp-servers create	Create a new MCP server with a name, URL, and optional authentication.
mcp-servers delete	Archive an MCP server (soft delete).
mcp-servers destroy	Permanently delete an archived MCP server.
mcp-servers get	Get a single MCP server by ID.
mcp-servers tools	List the tools an MCP server offers, with each tool’s annotations and saved risk label.
mcp-servers list	List all active MCP servers.
mcp-servers label-tool	Set or clear a person’s risk label for one MCP server tool.
mcp-servers update	Update an MCP server.

mcp-servers create

Create a new MCP server with a name, URL, and optional authentication.

everruns mcp-servers create [OPTIONS] --name <name> --url <url>

Flag	Description
--api-key <API_KEY>	API key for authentication (optional).
--auth-mode <AUTH_MODE>
--description <DESCRIPTION>	A human-readable description of what the MCP server provides.
--elicitation-policy <ELICITATION_POLICY>
--headers <HEADERS>	Additional HTTP headers for authentication.
--name <NAME>	Required. The name of the MCP server.
--protocol-mode <PROTOCOL_MODE>
--service-connection-provider <SERVICE_CONNECTION_PROVIDER>	Connection provider whose connection on an agent’s service virtual user supplies the service …
--transport-type <TRANSPORT_TYPE>	MCP Server transport type. One of http, stdio.
--url <URL>	Required. The URL of the MCP server endpoint.

Example:

# Register an MCP server so agents can use its tools
everruns mcp-servers create --name github --url https://api.example.com/mcp --reason 'Give agents GitHub tools'

mcp-servers delete

Archive an MCP server (soft delete). Can be restored.

everruns mcp-servers delete [OPTIONS] [ID]

Flag	Description
--id <ID>	Prefixed public identifier.

Example:

# Archive an MCP server, keeping it restorable
everruns mcp-servers delete mcp_01h9 --reason 'Moved to the hosted GitHub server'

mcp-servers destroy

Permanently delete an archived MCP server.

everruns mcp-servers destroy [OPTIONS] [ID]

Flag	Description
--id <ID>	Prefixed public identifier.

Example:

# Permanently remove an already-archived MCP server
everruns mcp-servers destroy mcp_01h9 --reason 'Retired after the archive window'

mcp-servers get

Get a single MCP server by ID.

everruns mcp-servers get [OPTIONS] [ID]

Flag	Description
--id <ID>	Prefixed public identifier.

Example:

# Show one MCP server's URL and configuration
everruns mcp-servers get mcp_01h9

mcp-servers tools

List the tools an MCP server offers, with each tool’s annotations and saved risk label.

everruns mcp-servers tools [OPTIONS] [ID]

Flag	Description
--id <ID>	Prefixed public identifier.

Example:

# See which tools of an MCP server ask for approval
everruns mcp-servers tools mcp_01h9

mcp-servers list

List all active MCP servers. Use search for name/description search, include_archived=true to include archived.

everruns mcp-servers list [OPTIONS]

Flag	Description
--include-archived
--search <SEARCH>

Example:

# Find a registered MCP server by name
everruns mcp-servers list --search github

mcp-servers label-tool

Set or clear a person’s risk label for one MCP server tool. read_only never asks for approval in normal mode, changes always asks, null clears.

everruns mcp-servers label-tool [OPTIONS] [ID] [TOOL_NAME]

Flag	Description
--id <ID>	Prefixed public identifier.
--tool-name <TOOL_NAME>	The tool’s own name on the MCP server.
--label <LABEL>

Example:

# Stop a read-only MCP tool from asking for approval
everruns mcp-servers label-tool mcp_01h9 search_docs --label read_only --reason 'Only reads documentation'

mcp-servers update

Update an MCP server. Only provided fields are changed.

everruns mcp-servers update [OPTIONS] [ID]

Flag	Description
--id <ID>	Prefixed public identifier.
--api-key <API_KEY>	API key for authentication.
--auth-mode <AUTH_MODE>
--description <DESCRIPTION>	A human-readable description of what the MCP server provides.
--elicitation-policy <ELICITATION_POLICY>
--headers <HEADERS>	Additional HTTP headers for authentication.
--name <NAME>	The name of the MCP server.
--protocol-mode <PROTOCOL_MODE>
--service-connection-provider <SERVICE_CONNECTION_PROVIDER>	Connection provider whose connection on an agent’s service virtual user supplies the service …
--status <STATUS>
--transport-type <TRANSPORT_TYPE>
--url <URL>	The URL of the MCP server endpoint.

Example:

# Repoint an MCP server at a new URL
everruns mcp-servers update mcp_01h9 --name github-prod --reason 'Rename for the production rollout'