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

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.

post

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.

Body

application/json

MCPServerStatusRequest

List of per-version deployment statuses for the MCP server.

versionstringrequired

The version identifier of the MCP server deployment.

Example:v1

desired_replicasintegerrequired

The desired number of replicas for this version.

>= 0

Example:2

created_replicasintegerrequired

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

>= 0

Example:2

pods_statusobjectrequired
Show Child Parameters

Response

Status accepted.

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

Body

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

Get generated Python code for the MCP Server

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

Generates MCP server Python code from the OpenAPI specifications associated with the MCP server.

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

Generated Python code for the MCP server

MCPServerCodeResponse

codestringrequired

Generated Python code for the MCP server implementation

Example:print("Hello MCP")

get/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}/code
 
application/json

MCPServerPodsStatus

object
readyintegerrequired

Number of pods in the ready state.

>= 0

Example:2

startingintegerrequired

Number of pods in the starting state.

>= 0

failingintegerrequired

Number of pods in the failing state.

>= 0

Example