Signaling APIs

Get MCP Server by Control Plane

Changed on

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

Retrieves an MCP server by its ID within a specific control plane context.

get/v1/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}

Request

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

Response

A response to retrieving a single MCP server within a control plane context.

idstring uuid required

The unique identifier for the MCP server.

namestring required

The name of the MCP server.

descriptionstring

A description of the MCP server.

labelsobject

Labels for the MCP server.

deployed_atstring date-time

The timestamp when the MCP server was deployed.

control_plane_idstring uuid nullable

The control plane ID associated with the MCP server.

resource_idstring uuid nullable

The MCP resource ID associated with the MCP server.

mode'basic' | 'advanced'

Whether the Context Interface deployment on this Control Plane is managed by Konnect defaults ('basic') or configured directly via Kong Operator custom resources ('advanced').

versionstring required

The version of the MCP server.

created_atstring date-time required

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time required

An ISO-8601 timestamp representation of entity update date.

Example response

{
  "created_at": "2022-11-04T20:10:06.927Z",
  "updated_at": "2022-11-04T20:10:06.927Z"
}

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