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
| Endpoint | Method | Purpose |
|---|---|---|
| Create Tool Server | POST | Register a new MCP tool server |
| List Tool Servers | GET | Retrieve all registered tool servers |
| Get Tool Server | GET | Get details and status of a specific server |
| Update Tool Server | PATCH | Modify server configuration or connection details |
| Sync Tool Server | POST | Refresh tool definitions from the server |
| Delete Tool Server | DELETE | Remove a tool server registration |
Configuration example
CONFIGURATION EXAMPLE
1