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
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/mcp/servers | Register a new MCP server |
GET | /v1/mcp/servers | List 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
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/mcp/servers/{id}/tools/refresh | Refresh available tools |
GET | /v1/mcp/servers/{id}/health | Check server health |
Access Management
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/mcp/servers/{id}/access | Grant agent access |
GET | /v1/mcp/servers/{id}/access | List access grants |
DELETE | /v1/mcp/servers/{id}/access/{agentId} | Revoke agent access |

