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

Partially Update MCP Server

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

Partially update an individual MCP server.

patch

Path Parameters

mcpServerIdstring(uuid)required

The ID of the MCP server.

Body

application/json

PatchMCPServerRequest

namestring

The name of the MCP server.

>= 1 characters<= 256 characters

descriptionstring | null

A description of the MCP server.

<= 1024 characters

labelsobject | null

Labels for the MCP server.

deployed_atstring | null(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.

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

patch/mcp-servers/{mcpServerId}

Body

{}
 
application/json

Delete MCP Server

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

Delete an MCP server.

delete

Path Parameters

mcpServerIdstring(uuid)required

The ID of the MCP server.

Response

Successfully deleted MCP server.

delete/mcp-servers/{mcpServerId}