Manage Keys & ServersEnable, disable, or rename a tool

Enable, disable, or rename a tool

is_enabled: false withdraws the tool from every client at once. To control it per client, leave it enabled and set access instead. Send at least one field.

curl -X PATCH "https://mythic-analytics.gulp.workers.dev/builder/mcp/tools/123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "is_enabled": false,
  "display_name": "Research lookup"
}'
{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "server_id": "123e4567-e89b-12d3-a456-426614174000",
    "server_name": "Internal research server",
    "name": "search_papers",
    "display_name": "Search Papers",
    "description": "example_string",
    "input_schema": {},
    "annotations": {},
    "is_enabled": true,
    "created_at": "2024-12-25T10:00:00Z"
  }
}
PATCH
/builder/mcp/tools/{id}
PATCH
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

An agency key (ak_). Location secret keys are rejected. Scoped keys (mcp_) are not accepted here (403 not_available_to_scoped_keys).

An agency key (ak_). Location secret keys are rejected. Scoped keys (mcp_) are not accepted here (403 not_available_to_scoped_keys).
Content-Typestring
Required

The media type of the request body

Options: application/json
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. An agency key (ak_). Location secret keys are rejected. Scoped keys (mcp_) are not accepted here (403 not_available_to_scoped_keys).

Path Parameters

Body

application/json
is_enabledboolean
Example:
false
display_namestring
Example:
Research lookup

Responses

dataobject