Ask the deployment's decision service to suggest read_only or changes for every tool of an MCP server that has no label yet. Suggestions are never applied: a person confirms one by setting the label.

POST

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

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

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

curl --request POST \
  --url https://app.everruns.com/api/v1/mcp-servers/example/tools/suggest-labels

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

503

No decision service is configured on this deployment