Partially Update MCP Server Tool
Pre-release Endpoint
This endpoint is currently in beta and is subject to change.
Partially update an individual MCP server tool.
Path Parameters
The ID of the MCP server.
The ID of the MCP server tool.
Body
application/json
Body
PatchMCPServerToolRequest
The unique name of the MCP server tool.
Match pattern:^[\w_-]+$
>= 1 characters<= 255 characters
The state of the MCP server tool.
Allowed values:draftpublished
Default:draft
Layout metadata for the MCP server tool.
Response
application/json
Response
A response to partially updating an MCP server tool.
MCPServerTool
The unique name of the MCP server tool.
Match pattern:^[\w_-]+$
>= 1 characters<= 255 characters
The state of the MCP server tool.
Allowed values:draftpublished
Default:draft
Layout metadata for the MCP server tool.
The unique identifier for the MCP server tool.
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
Authentication
Path Parameters
Body
Delete MCP Server Tool
Pre-release Endpoint
This endpoint is currently in beta and is subject to change.
Delete an MCP server tool under the specified MCP server.
Path Parameters
The ID of the MCP server.
The ID of the MCP server tool.
Response
Response
Successfully deleted MCP server tool.
Authentication
Path Parameters
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.