Skip to main content
Version: 2.0

Tool Server Management APIs

The Tool Server Management APIs handle Model Context Protocol (MCP) tool servers that extend agent capabilities with external integrations and custom functionality.

  • Create tool servers to connect MCP-compatible services
  • List available tool servers in your environment
  • Get server details including connection status and available tools
  • Update server configurations to modify connection parameters
  • Sync tool definitions to refresh available tools from servers
  • Delete tool servers when no longer needed

Model Context Protocol (MCP)​

MCP is a protocol that enables agents to connect to external tools and services:

  • Standardized interface: Consistent way to expose tools to agents
  • Server-sent events (SSE): Communication via SSE transport
  • Authentication support: Controlled access to external systems
  • Dynamic discovery: Tools are discovered and synchronized from servers

Tool server capabilities​

MCP tool servers can provide various external functionalities:

  • Database access: Query databases and retrieve structured data
  • API integrations: Connect to REST APIs and web services
  • File operations: Access and manipulate files and documents
  • Custom business logic: Domain-specific functionality and workflows

Available endpoints​

EndpointMethodPurpose
Create Tool ServerPOSTRegister a new MCP tool server
List Tool ServersGETRetrieve all registered tool servers
Get Tool ServerGETGet details and status of a specific server
Update Tool ServerPATCHModify server configuration or connection details
Sync Tool ServerPOSTRefresh tool definitions from the server
Delete Tool ServerDELETERemove a tool server registration

Configuration example​

CONFIGURATION EXAMPLE

Code example with json syntax.
1