MCP Servers

List all MCP Servers

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

Returns an array of MCP server objects.

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

Response

application/json

A response to listing MCP servers.

ListMCPServersResponse

dataarray[object]required
Show Child Parameters
metaobjectrequired

Pagination metadata.

Show Child Parameters
get/mcp-servers
 
application/json

Create an MCP Server

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

Create an MCP Server in the Konnect Organization.

post

Body

application/json

CreateMCPServerRequest

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.

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.

Response

application/json

A response to creating an MCP server.

MCPServerInfo

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

post/mcp-servers

Body

{ "name": "name" }
 
application/json

Get MCP Server

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

Returns information about an individual MCP server.

get

Path Parameters

mcpServerIdstring(uuid)required

The ID of the MCP server.

Response

application/json

A response to retrieving a single MCP server.

MCPServerInfo

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

get/mcp-servers/{mcpServerId}
 
application/json

Update MCP Server

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

Update an individual MCP server.

put

Path Parameters

mcpServerIdstring(uuid)required

The ID of the MCP server.

Body

application/json

UpdateMCPServerRequest

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.

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.

Response

application/json

A response to updating an MCP server.

MCPServerInfo

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

put/mcp-servers/{mcpServerId}

Body

{ "name": "name" }
 
application/json