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.

delete

Path Parameters

mcpServerIdstring(uuid)required

The ID of the MCP server.

toolIdstring(uuid)required

The ID of the MCP server tool.

Response

Successfully deleted MCP server tool.

delete/mcp-servers/{mcpServerId}/tools/{toolId}
 

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.

get

Query Parameters

capabilitiesobject

Map of capability name -> capability request fields.

Example:
{
“mcp”: { “version”: “v1”, “offset”: “5” }
}

Example:{"mcp":{"version":"5"}}

Show Child Parameters

Path Parameters

controlPlaneIdstring(uuid)required

The UUID of your control plane. This variable is available in the Konnect manager.

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

Response

application/json

The MCP server signals response.

MCPServerSignals

The MCP server signals response.

signalsOne Of
arrayrequired

A single signal envelope containing exactly one typed capability signal.

MCPServerSignalV1object

Signal notifying the client that the MCP control plane config has changed.

Example:{"type":"mcp","version":"v1","offset":"6"}

* Additional properties are NOT allowed.
Show Child Parameters
get/mcp-cp/{controlPlaneId}/signals
 
application/json

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.

get

Query Parameters

page[size]integer

The maximum number of items to include per page. The last page of a collection may include fewer items.

Example:10

page[after]string

Request the next page of data, starting with the item after this parameter.

Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ

filterobject

Filter documents returned in the response.

Show Child Parameters

Path Parameters

controlPlaneIdstring(uuid)required

The UUID of your control plane. This variable is available in the Konnect manager.

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

Response

application/json

A response to listing MCP servers with CP info.

ListMCPServersCPInfoResponse

dataarrayrequired
Show Child Parameters
metaobjectrequired

Pagination metadata.

Show Child Parameters
get/mcp-cp/{controlPlaneId}/mcp-servers
 
application/json

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.

get

Path Parameters

controlPlaneIdstring(uuid)required

The UUID of your control plane. This variable is available in the Konnect manager.

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

mcpServerIdstring(uuid)required

The ID of the MCP server.

Response

application/json

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

MCPServerCPInfo

idstring(uuid)required

The unique identifier for the MCP server.

namestringrequired

The name of the MCP server.

>= 1 characters<= 256 characters

descriptionstring

A description of the MCP server.

<= 1024 characters

labelsobject

Labels for the MCP server.

deployed_atstring(date-time)

The timestamp when the MCP server was deployed.

control_plane_idstring | null(uuid)

The control plane ID associated with the MCP server.

resource_idstring | null(uuid)

The MCP resource ID associated with the MCP server.

versionstringrequired

The version of the MCP server.

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

containerobject

Configuration for the main container.

Show Child Parameters
init_containerobject

Configuration for the init container.

Show Child Parameters
get/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}
 
application/json

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.

get

Query Parameters

runtime_versionstring

Kong Gateway runtime version to generate entities for

Example:3.13.0.0

Path Parameters

controlPlaneIdstring(uuid)required

The UUID of your control plane. This variable is available in the Konnect manager.

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

mcpServerIdstring(uuid)required

The ID of the MCP server.

Response

application/json

Kong entities for the MCP server

KongEntitiesResponse

routesarray[object]required
Show Child Parameters
servicesarray[object]required
Show Child Parameters
get/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}/kong-entities
 
application/json