sim mcp-servers is also spelled sim mcp-server.
Every command below also accepts the global options.
Create MCP server
sim mcp-servers create [options]Options
| Option | Required | Description |
|---|---|---|
--name <value> | Yes | Server display name. |
--description <value> | No | Optional server description. |
--transport <value> | No | Transport protocol. Defaults to streamable-http on creation. Accepted values: streamable-http. |
--url <value> | Yes | Absolute HTTP or HTTPS endpoint URL without {{ENV_VAR}} references. It determines server identity and is immutable: delete and recreate the server to change endpoints. |
--auth-type <value> | No | Authentication method. When omitted, and no headers are sent, registration probes the endpoint once to classify it, falling back to headers when the probe fails or the server does not advertise OAuth. A server publishing RFC 9728 metadata is therefore stored as oauth, and headers configured afterwards will not authenticate — send this field explicitly to pin the method. Accepted values: none, headers, oauth. |
--headers <json|@file> | No | Write-only request headers sent to the server. Replaced wholesale rather than merged on update: sending this field drops every stored header it does not repeat. (JSON, or @path / @- to read a file or stdin). |
--timeout <value> | No | Per-request timeout in milliseconds. Defaults to 30000 on creation. |
--retries <value> | No | Number of retries per request. Defaults to 3 on creation. |
--enabled | No | Whether workflows can use the server's tools. Defaults to true on creation. |
--no-enabled | No | Send --enabled as false. |
--oauth-client-id <value> | No | Pre-registered OAuth client identifier. Changing it on update revokes the stored OAuth grant and forces reauthorization. |
--oauth-client-secret <value> | No | Write-only pre-registered OAuth client secret. Sending it on update as null or a new value revokes the stored OAuth grant and forces reauthorization, as does switching away from OAuth authentication. (--oauth-client-secret null sends the word, not JSON null). |
Delete MCP server
sim mcp-servers delete <mcpServerId> [options]Arguments
| Argument | Required | Description |
|---|---|---|
mcpServerId | Yes | Unique MCP server identifier. |
Options
| Option | Required | Description |
|---|---|---|
-y, --yes | Yes | Confirm this operation. |
Get MCP server
sim mcp-servers get <mcpServerId>Arguments
| Argument | Required | Description |
|---|---|---|
mcpServerId | Yes | Unique MCP server identifier. |
List MCP servers
sim mcp-servers list [options]Options
| Option | Required | Description |
|---|---|---|
--search <value> | No | Case-insensitive substring match against the server name. |
--sort-by <value> | No | Field used to sort the result. Sorting by name is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: name, createdAt, updatedAt. |
--sort-order <value> | No | Sort direction. Accepted values: asc, desc. |
--limit <n> | No | Maximum items to return (0 for everything). Defaults to 0. |
List MCP server tools
sim mcp-servers tools list <mcpServerId> [options]List MCP Server Tools (OAuth login or personal API key required)
Arguments
| Argument | Required | Description |
|---|---|---|
mcpServerId | Yes | Unique MCP server identifier. |
Options
| Option | Required | Description |
|---|---|---|
--refresh | No | Refresh tools using your credentials. Otherwise results may reuse another workspace member's recent discovery and omit newly added tools. |
--no-refresh | No | Send --refresh as false. |
Update MCP server
sim mcp-servers update <mcpServerId> [options]Arguments
| Argument | Required | Description |
|---|---|---|
mcpServerId | Yes | Unique MCP server identifier. |
Options
| Option | Required | Description |
|---|---|---|
--name <value> | No | Server display name. |
--description <value> | No | Optional server description. |
--transport <value> | No | Transport protocol. Defaults to streamable-http on creation. Accepted values: streamable-http. |
--url <value> | No | Immutable server URL. When provided, it must equal the current URL; use delete and create to change endpoints. |
--auth-type <value> | No | Authentication method. When omitted, and no headers are sent, registration probes the endpoint once to classify it, falling back to headers when the probe fails or the server does not advertise OAuth. A server publishing RFC 9728 metadata is therefore stored as oauth, and headers configured afterwards will not authenticate — send this field explicitly to pin the method. Accepted values: none, headers, oauth. |
--headers <json|@file> | No | Write-only request headers sent to the server. Replaced wholesale rather than merged on update: sending this field drops every stored header it does not repeat. (JSON, or @path / @- to read a file or stdin). |
--timeout <value> | No | Per-request timeout in milliseconds. Defaults to 30000 on creation. |
--retries <value> | No | Number of retries per request. Defaults to 3 on creation. |
--enabled | No | Whether workflows can use the server's tools. Defaults to true on creation. |
--no-enabled | No | Send --enabled as false. |
--oauth-client-id <value> | No | Pre-registered OAuth client identifier. Changing it on update revokes the stored OAuth grant and forces reauthorization. |
--oauth-client-secret <value> | No | Write-only pre-registered OAuth client secret. Sending it on update as null or a new value revokes the stored OAuth grant and forces reauthorization, as does switching away from OAuth authentication. (--oauth-client-secret null sends the word, not JSON null). |