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

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

PUT

/v1/mcp-servers/{id}/tools/{tool\_name}/label

Select code samplecURL (shell:curl)

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

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

* Production APIapp.everruns.com/api/v1/mcp-servers/{id}/tools/{tool\_name}/label

## Parameters

### Path Parameters

**id**

required

string

Prefixed public identifier

**tool\_name**

required

string

Prefixed public identifier

## Responses

### 200

Success

Media typeapplication/json

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

object

**annotations**

One of:

* object

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

  object

  **destructiveHint**

  boolean | null

  **idempotentHint**

  boolean | null

  **openWorldHint**

  boolean | null

  **readOnlyHint**

  boolean | null

* null

  null

**description**

What the tool does, as the server describes it.

string | null

**label**

One of:

* string

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

  string

  Allowed values: read\_only changes

* null

  null

**name**

required

The tool’s own name on the MCP server.

string

**suggested\_label**

One of:

* string

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

  string

  Allowed values: read\_only changes

* null

  null

**title**

Human-readable title the server gives the tool.

string | null

##### Example

```json
{
  "label": "read_only",
  "name": "search_docs",
  "suggested_label": "read_only"
}
```

### 404

MCP server or tool not found