Read one of the person's MCP servers.

GET

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

const url = 'https://app.everruns.com/api/v1/virtual-users/example/mcp-servers/example';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.everruns.com/api/v1/virtual-users/example/mcp-servers/example

Parameters

Path Parameters

identity_id

required

string

me or a virtual user id

server_id

required

string

Responses

200

Success

application/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>

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"
}

401

Authentication required

403

Permission denied

404

Not found