For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Usage

client.mcp_servers.update_tools(
    server_ref="docs",
    body={
        "enabledToolSlugs": [...],
        "user_id": "",
    },
)

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

server_ref string required

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

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.

user_id 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

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "enabledToolSlugs": [
    "docs_get_page"
  ]
}

resp = client.mcp_servers.update_tools(server_ref="docs", body=req)

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.