Sync MCP Server Capabilities

zero_trust.access.ai_controls.mcp.servers.sync(, ) -> ServerSyncResponse

POST/accounts/{account_id}/access/ai-controls/mcp/servers/{id}/sync

Syncs an MCP server’s capabilities and returns the updated server state, including any connection errors.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

MCP Portals Write

ParametersExpand Collapse

account_id: str

id: str

portal id

maxLength32

minLength1

ReturnsExpand Collapse

class ServerSyncResponse: …

error: Optional[str]

error_details: Optional[ErrorDetails]

cause: Optional[str]

Underlying error message

is_upstream: Optional[bool]

True = MCP server returned an error. False = couldn’t reach the server

mcp_code: Optional[float]

MCP protocol error code

retryable: Optional[bool]

Whether the error is transient and worth retrying

status_code: Optional[float]

HTTP status code from the server

status: Optional[str]

Sync MCP Server Capabilities

import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
response = client.zero_trust.access.ai_controls.mcp.servers.sync(
    id="my-mcp-portal",
    account_id="a86a8f5c339544d7bdc89926de14fb8c",
)
print(response.error)

{
  "result": {
    "error": "error",
    "error_details": {
      "cause": "cause",
      "is_upstream": true,
      "mcp_code": 0,
      "retryable": true,
      "status_code": 0
    },
    "status": "status"
  },
  "success": true
}

Returns Examples

{
  "result": {
    "error": "error",
    "error_details": {
      "cause": "cause",
      "is_upstream": true,
      "mcp_code": 0,
      "retryable": true,
      "status_code": 0
    },
    "status": "status"
  },
  "success": true
}