List the tools of one of the person's custom MCP servers, asked live, with their risk labels.

GET

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

const url = 'https://app.everruns.com/api/v1/virtual-users/example/mcp-servers/example/tools';
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/tools

Parameters

Path Parameters

identity_id

required

string

me or a virtual user id

server_id

required

string

Responses

200

Success

application/json

List response for the tools of a user MCP server.

object

data

required

Array<object>

One tool an MCP server offers, with its saved risk label.

object

annotations

One of:

object
null

Hints the server declares about the tool (read-only, destructive, …).

object

destructiveHint

boolean | null

idempotentHint

boolean | null

openWorldHint

boolean | null

readOnlyHint

boolean | null

description

What the tool does, as the server describes it.

string | null

label

One of:

string
null

Risk label a person set. It wins over the annotations; null means none.

string

Allowed values: read_only changes

name

required

The tool’s own name on the MCP server.

string

suggested_label

One of:

string
null

Suggested label waiting for a person to confirm. Never applied by itself.

string

Allowed values: read_only changes

title

Human-readable title the server gives the tool.

string | null

Example

{
  "data": [
    {
      "label": "read_only",
      "name": "search_docs",
      "suggested_label": "read_only"
    }
  ]
}

400

Server was added from the catalog

401

Authentication required

403

Permission denied

404

Not found