Rename, enable, disable or replace the API key of one of the person's MCP servers.

PATCH

/v1/virtual-users/{identity_id}/mcp-servers/{server_id}

curl --request PATCH \
  --url https://app.everruns.com/api/v1/virtual-users/example/mcp-servers/example \
  --header 'Content-Type: application/json' \
  --data '{ "api_key": "example", "description": "example", "enabled": true, "name": "example" }'

• Production API

Parameters

Path Parameters

identity_id

required

string

me or a virtual user id

server_id

required

string

Request Body^required

Media typeapplication/json

Change a user MCP server. The URL cannot change; remove and re-add the server instead.

object

api_key

Replace the API key of an api_key server.

string | null

description

string | null

enabled

boolean | null

name

string | null

Example^generated

{
  "api_key": "example",
  "description": "example",
  "enabled": true,
  "name": "example"
}

Responses

200

Success

Media typeapplication/json

An MCP server a person added for themselves.

object

auth_mode

required

MCP server authentication mode.

string

Allowed values: none api_key oauth

catalog_name

Catalog preset name, for servers added from the catalog.

string | null

connection

required

Sign-in state of a user MCP server.

object

connected_at

string | null format: date-time

provider

Connection provider to pass to the authorize endpoint (/v1/virtual-users/{id}/connections/{provider}/authorize) when the server signs in with OAuth.

string | null

status

required

Whether the person has signed in to a user MCP server.

string

Allowed values: connected not_connected not_needed

created_at

required

string format: date-time

description

string | null

enabled

required

Disabled servers are kept but never offered to agents.

boolean

header_names

Names of the literal headers sent with each request. Values are write-only.

Array<string>

id

required

string

name

required

string

source

required

Where a user MCP server came from.

string

Allowed values: catalog custom

updated_at

required

string format: date-time

url

required

string

Example

{
  "auth_mode": "none",
  "connection": {
    "status": "connected"
  },
  "id": "mcp_01933b5a00007000800000000000001",
  "source": "catalog"
}

400

Invalid request

401

Authentication required

403

Permission denied

404

Not found

409

Name already used