Set or clear a person's risk label for one MCP server tool. read_only never asks for approval in normal mode, changes always asks, null clears.

PUT

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

const url = 'https://app.everruns.com/api/v1/mcp-servers/example/tools/example/label';
const options = {method: 'PUT'};

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

curl --request PUT \
  --url https://app.everruns.com/api/v1/mcp-servers/example/tools/example/label

Parameters

Path Parameters

required

string

Prefixed public identifier

tool_name

required

string

Prefixed public identifier

Responses

200

Success

application/json

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 or tool not found