Give Feedback

pydo.mcp_servers.patch()

Generated on 1 Oct 2026 from pydo version v0.43.0

Copy page as Markdown View page as Markdown

Usage

client.mcp_servers.patch(
    server_ref="docs",
    body={
        "description": "Internal documentation and runbook search.",
    },
)

Returns JSONRaises HttpResponseError

Description

Changes the server’s description, which is shown on its catalog card immediately. The endpoint and credentials cannot be changed; to change them, delete the server and register it again.

Parameters

server_ref string required

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

description string optional

Example: Internal documentation and runbook search.

Replaces the stored description; empty clears it. At most 1024 characters.

Max length: 1024

Request Sample

Show Request Sample

import os
from pydo import Client

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

req = {
  "description": "Internal documentation and runbook search."
}

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

Response Example

Show 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-21T10:00:00Z",
    "description": "Internal documentation and runbook search.",
    "oauth_authorize_url": "",
    "oauth_scopes": [],
    "oauth_authorization_ttl_seconds": "0"
  }
}

More Information

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