dots.v2.actionGateway.mcpServers.byServer_ref().tools.put()

Generated on 13 Nov 2026 from DoTs version v1.24.0

Usage

client.v2.actionGateway.mcpServers.byServer_ref(server_ref).tools.put(body: Mcp_server_tools_update, requestConfiguration?: RequestConfiguration<object>): Promise<undefined | List_mcp_server_tools_response>

Description

enabledToolSlugs is the complete set to enable; every other tool of the server is disabled. An enabled tool is added to your team’s catalog at its latest discovered version, and a disabled one is removed from it. Repeating the same set changes nothing.

Before changing anything, each tool being enabled, re-enabled, or moved to a newer discovered version is verified against the live server: it must still be listed there, with the same input schema as when it was discovered. If any check fails or the server cannot be reached, the request fails with 400 and nothing changes; resync and try again. An unknown tool slug is also rejected with 400. A request that needs verification counts against the resync rate limit (429). Returns the server’s full tool list.

Parameters

Path Parameters

server_ref string required

Example: docs

Server identifier (serverRef) of one of your team's MCP servers.

Request Body

enabledToolSlugs array of strings required

Example: ["docs_search", "docs_get_page"]

The complete set of tool slugs (<server_ref>_<name>) to enable; every other tool of the server is disabled. Empty disables every tool.

userId string optional

Required for a server registered with credentialRefSource connection when a tool needs verification against the live server, which can only be reached as a user who has authorized it. Ignored otherwise.

Request Sample

Show Request Sample
import { FetchRequestAdapter } from "@microsoft/kiota-http-fetchlibrary";
import {
    createDigitalOceanClient,
    DigitalOceanApiKeyAuthenticationProvider,
} from "@digitalocean/dots";

const authProvider = new DigitalOceanApiKeyAuthenticationProvider(process.env.DIGITALOCEAN_TOKEN!);
const adapter = new FetchRequestAdapter(authProvider);
const client = createDigitalOceanClient(adapter);

const response = await client.v2.actionGateway.mcpServers
    .byServer_ref("docs").tools.put({
    enabledToolSlugs: [
        "docs_get_page",
    ],
});

Response Example

Show Response Example
{
  "tools": [
    {
      "name": "get_page",
      "toolSlug": "docs_get_page",
      "description": "Fetch one documentation page.",
      "enabled": true,
      "quarantined": false,
      "quarantineReason": ""
    },
    {
      "name": "search",
      "toolSlug": "docs_search",
      "description": "Search the documentation index.",
      "enabled": false,
      "quarantined": false,
      "quarantineReason": ""
    }
  ]
}

More Information

See /v2/action-gateway/mcp-servers/{server_ref}/tools in the API reference for additional detail on responses, headers, parameters, and more.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.