Skip to main content

MCP Servers

MCP server endpoints let you register remote MCP servers, manage their configuration, and control which agents can access their tools.
Only remote-hosted (HTTP) MCP servers are supported at the moment.

Endpoints

Server Management

MethodEndpointDescription
POST/v1/mcp/serversRegister a new MCP server
GET/v1/mcp/serversList all MCP servers
GET/v1/mcp/servers/{id}Get server details
PUT/v1/mcp/servers/{id}Update server configuration
DELETE/v1/mcp/servers/{id}Delete a server

Health & Tools

MethodEndpointDescription
POST/v1/mcp/servers/{id}/tools/refreshRefresh available tools
GET/v1/mcp/servers/{id}/healthCheck server health

Access Management

MethodEndpointDescription
POST/v1/mcp/servers/{id}/accessGrant agent access
GET/v1/mcp/servers/{id}/accessList access grants
DELETE/v1/mcp/servers/{id}/access/{agentId}Revoke agent access
For a conceptual guide, see MCP Server Management.