Get MCP Server Tool

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

Returns information about an individual MCP server tool.

get

Path Parameters

mcpServerIdstring(uuid)required

The ID of the MCP server.

toolIdstring(uuid)required

The ID of the MCP server tool.

Response

application/json

A response to retrieving a single MCP server tool.

MCPServerTool

namestringrequired

The unique name of the MCP server tool.

Match pattern:^[\w_-]+$

>= 1 characters<= 255 characters

statestring

The state of the MCP server tool.

Allowed values:draftpublished

Default:draft

definitionarray[object]
* Additional properties are allowed.
definition_draftarray[object]
* Additional properties are allowed.
layout_metadataobject

Layout metadata for the MCP server tool.

* Additional properties are allowed.
idstring(uuid)required

The unique identifier for the MCP server tool.

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}/tools/{toolId}
 
application/json

Update MCP Server Tool

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

Update an individual MCP server tool.

put

Path Parameters

mcpServerIdstring(uuid)required

The ID of the MCP server.

toolIdstring(uuid)required

The ID of the MCP server tool.

Body

application/json

MCPServerToolInput

namestringrequired

The unique name of the MCP server tool.

Match pattern:^[\w_-]+$

>= 1 characters<= 255 characters

statestring

The state of the MCP server tool.

Allowed values:draftpublished

Default:draft

definitionarray[object]
* Additional properties are allowed.
definition_draftarray[object]
* Additional properties are allowed.
layout_metadataobject

Layout metadata for the MCP server tool.

* Additional properties are allowed.

Response

application/json

A response to updating an MCP server tool.

MCPServerTool

namestringrequired

The unique name of the MCP server tool.

Match pattern:^[\w_-]+$

>= 1 characters<= 255 characters

statestring

The state of the MCP server tool.

Allowed values:draftpublished

Default:draft

definitionarray[object]
* Additional properties are allowed.
definition_draftarray[object]
* Additional properties are allowed.
layout_metadataobject

Layout metadata for the MCP server tool.

* Additional properties are allowed.
idstring(uuid)required

The unique identifier for the MCP server tool.

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}/tools/{toolId}

Body

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

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.

patch

Path Parameters

mcpServerIdstring(uuid)required

The ID of the MCP server.

toolIdstring(uuid)required

The ID of the MCP server tool.

Body

application/json

PatchMCPServerToolRequest

namestring

The unique name of the MCP server tool.

Match pattern:^[\w_-]+$

>= 1 characters<= 255 characters

statestring

The state of the MCP server tool.

Allowed values:draftpublished

Default:draft

definitionarray[object]
* Additional properties are allowed.
definition_draftarray[object]
* Additional properties are allowed.
layout_metadataobject | null

Layout metadata for the MCP server tool.

* Additional properties are allowed.

Response

application/json

A response to partially updating an MCP server tool.

MCPServerTool

namestringrequired

The unique name of the MCP server tool.

Match pattern:^[\w_-]+$

>= 1 characters<= 255 characters

statestring

The state of the MCP server tool.

Allowed values:draftpublished

Default:draft

definitionarray[object]
* Additional properties are allowed.
definition_draftarray[object]
* Additional properties are allowed.
layout_metadataobject

Layout metadata for the MCP server tool.

* Additional properties are allowed.
idstring(uuid)required

The unique identifier for the MCP server tool.

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}/tools/{toolId}

Body

{}
 
application/json

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