Create MCP Server Tool

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

Create an MCP server tool under the specified MCP server.

post

Path Parameters

mcpServerIdstring(uuid)required

The ID of the MCP server.

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 creating 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

post/mcp-servers/{mcpServerId}/tools

Body

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

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}