# Read one of the person's MCP servers.

Source: <https://everruns.com/docs/api/operations/get_user_mcp_server/>

GET

/v1/virtual-users/{identity\_id}/mcp-servers/{server\_id}

Select code samplecURL (shell:curl)

```js
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);
}
```

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

* Production APIapp.everruns.com/api/v1/virtual-users/{identity\_id}/mcp-servers/{server\_id}

## Parameters

### Path Parameters

**identity\_id**

required

string

`me` or a virtual user id

**server\_id**

required

string

## 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

**deferred**

required

Whether the server loads on demand: agents see one line for it and list its tools only once they search for them. Off lists its tools from the start of every turn.

boolean

**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

**presentation**

One of:

* object

  Title, icon, and links published by the remote server.

  object

  **description**

  string | null

  **documentation\_url**

  string | null

  **fetched\_at**

  string | null format: date-time

  **icons**

  Array\<object>

  object

  **mime\_type**

  string | null

  **sizes**

  Array\<string>

  **src**

  required

  `https` URL on the MCP server’s origin, or a raster `data:` URI.

  string

  **theme**

  One of:

  * string

    string

    Allowed values: light dark

  * null

    null

  **sources**

  Which documents contributed. Not shown in the UI.

  Array\<string>

  **title**

  string | null

  **version**

  string | null

  **website\_url**

  string | null

* null

  string

  Allowed values: light dark

* string

  null

* null

  null

**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

```json
{
  "auth_mode": "none",
  "connection": {
    "status": "connected"
  },
  "id": "mcp_01933b5a00007000800000000000001",
  "presentation": {
    "icons": [
      {
        "theme": "light"
      }
    ],
    "title": "GitHub MCP Server",
    "website_url": "https://github.com"
  },
  "source": "catalog"
}
```

### 401

Authentication required

### 403

Permission denied

### 404

Not found