Signaling APIs

Report MCP Server deployment status

Changed on

Pre-release Endpoint This endpoint is currently in beta and is subject to change.

Reports the current deployment status of an MCP server, including replica counts and per-version pod statuses.

post/v1/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}/status

Request

  • Base URL: https://global.api.konghq.com
  • URL: https://global.api.konghq.com/v1/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}/status
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Request body

versionstring required

The version identifier of the MCP server deployment.

desired_replicasinteger required

The desired number of replicas for this version.

created_replicasinteger required

The number of replicas that have been created for this version.

Example request

[
  {
    "version": "v1",
    "desired_replicas": 2,
    "created_replicas": 2,
    "pods_status": {
      "ready": 2
    }
  }
]

Response

Status accepted.

Changes

  • 7aab863a6daaRevision changes
    • breaking

      added to the / response property oneOf list for the response status

    • warning

      added the new key_invalid enum value to the ////// response property for the response status

    • warning

      added the new unique enum value to the ////// response property for the response status

  • de79e1192f11Revision changes
    • info

      api tag Signaling APIs added

    • info

      api tag MCP Servers removed