Get MCP Server Signals
Pre-release Endpoint
This endpoint is currently in beta and is subject to change.
Client-initiated signals fetch with long-polling capabilities.
The client supplies capabilities as a deepObject query parameter:
- Keys are capability names (e.g.
mcp) - Values contain the capability request fields (
version)
Example:
GET /mcp-cp/{controlPlaneId}/signals?capabilities[mcp][version]=5
The CP responds with a JSON payload containing zero or more signals that the client should process.
If no signals are available, the CP responds with HTTP 304 Not Modified.
Query Parameters
Map of capability name -> capability request fields.
Example:
{
“mcp”: { “version”: “v1”, “offset”: “5” }
}
Example:{"mcp":{"version":"5"}}
Show Child Parameters
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Response
application/json
Response
The MCP server signals response.
MCPServerSignals
The MCP server signals response.
One OfA single signal envelope containing exactly one typed capability signal.
Signal notifying the client that the MCP control plane config has changed.
Example:{"type":"mcp","version":"v1","offset":"6"}
Show Child Parameters
Authentication
Path Parameters
Query Parameters
List MCP Servers by Control Plane
Pre-release Endpoint
This endpoint is currently in beta and is subject to change.
Returns an array of MCP server objects for the specified control plane.
Query Parameters
The maximum number of items to include per page. The last page of a collection may include fewer items.
Example:10
Request the next page of data, starting with the item after this parameter.
Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ
Filter documents returned in the response.
Show Child Parameters
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Response
application/json
Response
A response to listing MCP servers with CP info.
ListMCPServersCPInfoResponse
Show Child Parameters
Pagination metadata.
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Get MCP Server by Control Plane
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.
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
The ID of the MCP server.
Response
application/json
Response
A response to retrieving a single MCP server within a control plane context.
MCPServerCPInfo
The unique identifier for the MCP server.
The name of the MCP server.
>= 1 characters<= 256 characters
A description of the MCP server.
<= 1024 characters
Labels for the MCP server.
The timestamp when the MCP server was deployed.
The control plane ID associated with the MCP server.
The MCP resource ID associated with the MCP server.
The version of the MCP server.
An ISO-8601 timestamp representation of entity creation date.
Example:2022-11-04T20:10:06.927Z
An ISO-8601 timestamp representation of entity update date.
Example:2022-11-04T20:10:06.927Z
Configuration for the main container.
Show Child Parameters
Configuration for the init container.
Show Child Parameters
Authentication
Path Parameters
Get Kong entities for the MCP Server Gateway
Pre-release Endpoint
This endpoint is currently in beta and is subject to change.
Retrieves Kong entities (Routes, Services, Plugins) for the Gateway in front of the MCP Server.
Query Parameters
Kong Gateway runtime version to generate entities for
Example:3.13.0.0
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
The ID of the MCP server.
Response
application/json
Response
Kong entities for the MCP server
KongEntitiesResponse
Show Child Parameters
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Report MCP Server deployment status
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.
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
The ID of the MCP server.
Body
application/json
Body
MCPServerStatusRequest
List of per-version deployment statuses for the MCP server.
The version identifier of the MCP server deployment.
Example:v1
The desired number of replicas for this version.
>= 0
Example:2
The number of replicas that have been created for this version.
>= 0
Example:2
Show Child Parameters
Response
Response
Status accepted.