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.run_resync(
    server_ref="docs",
    body={
        "user_id": "alice",
    },
)

Description

Connects to the server, lists its tools, and records them. Discovered tools are not callable until you enable them.

When discovery finishes in time, returns 200 with the server and its tools; a discovery failure is reported in syncStatus and syncError rather than as an error. Otherwise returns 202 with pending set while discovery continues: poll GET .../mcp-servers/{server_ref} until lastSyncedAt or syncError changes (syncStatus is not reset while discovery runs).

For a server registered with credentialRefSource connection, user_id is required; if that user has not authorized the server yet, the response carries authorization with the URL to send them to. Resyncs are rate limited per team, and a team can run only a few discoveries at once; either limit returns 429.

Parameters

server_ref string required

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

user_id string optional

Example: alice

Required for a server registered with credentialRefSource connection: discovery reaches the server as this user, through their connection, because such a server has no team-wide credential. Ignored otherwise.

Request Sample

import os
from pydo import Client

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

req = {}

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

Response Example

{
  "mcpServer": {
    "serverRef": "docs",
    "endpoint": "https://mcp.example.com/mcp",
    "transport": "streamable_http",
    "credentialRefSource": "secret",
    "credentialRef": "action-infra/tool-credentials/mcp/docs/3f5b2c1e-9a7d-4e8b-b6c4-2d1f0e9a8b7c",
    "syncStatus": "ok",
    "syncError": "",
    "lastSyncedAt": "2026-09-20T15:04:05Z",
    "protocolVersion": "2025-06-18",
    "toolCount": 2,
    "createdAt": "2026-09-20T15:00:00Z",
    "updatedAt": "2026-09-20T15:04:05Z",
    "description": "Internal documentation search.",
    "oauth_authorize_url": "",
    "oauth_scopes": [],
    "oauth_authorization_ttl_seconds": "0"
  },
  "tools": [
    {
      "name": "get_page",
      "toolSlug": "docs_get_page",
      "description": "Fetch one documentation page.",
      "enabled": false,
      "quarantined": false,
      "quarantineReason": ""
    },
    {
      "name": "search",
      "toolSlug": "docs_search",
      "description": "Search the documentation index.",
      "enabled": false,
      "quarantined": false,
      "quarantineReason": ""
    }
  ],
  "pending": false,
  "authorization": null
}

More Information

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