Give Feedback

pydo.mcp_servers.delete()

Generated on 1 Oct 2026 from pydo version v0.43.0

Copy page as Markdown View page as Markdown

Usage

client.mcp_servers.delete(server_ref="docs")

Returns JSONRaises HttpResponseError

Description

Disables all of the server’s tools, removes them from your team’s catalog, and deletes the server. An api_key supplied at registration is deleted; a credentialRef you supplied is left untouched. For a server registered with credentialRefSource connection, every user connection made through its OAuth client is revoked. Returns the deleted server, or 404 when it does not exist.

Parameters

server_ref string required: Server identifier (serverRef) of one of your team's MCP servers.

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-20T15:04:05Z",
    "description": "Internal documentation 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.