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

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

Method	Endpoint	Description
`POST`	`/v1/mcp/servers/{id}/tools/refresh`	Refresh available tools
`GET`	`/v1/mcp/servers/{id}/health`	Check server health

Method	Endpoint	Description
`GET`	`/v1/mcp/servers/{id}/oauth/authorize`	Initiate OAuth flow for MCP server
`POST`	`/v1/mcp/servers/{id}/oauth/callback`	OAuth callback endpoint

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

For a conceptual guide, see MCP Server Management.