List the tools an MCP server offers, with each tool's annotations and saved risk label.

GET

/v1/mcp-servers/{id}/tools

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

Parameters

Path Parameters

required

string

Prefixed public identifier

Responses

200

Success

application/json

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

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

404

MCP server not found