MCP servers
Manage the MCP servers registered in the workspace — the tool providers agents attach to. To attach a server to a specific agent, see Agents. To talk to an agent as an MCP server, see Agent MCP.
All paths are relative to the base URL and require an Authorization: Bearer YOUR_API_KEY header.
The MCP server object
PublicMcpServer:
| Field | Type | Description |
|---|---|---|
| id | string | Server ID. |
| name | string | Display name. |
| transport | string | How the server is reached (e.g. streamable-http, sse, stdio). |
| url | string | Endpoint URL (remote transports). |
| headers | object | Headers sent with each request (remote transports). |
| command | string | Executable to run (local stdio transport). |
| args | array | Arguments for the command. |
| env | object | Environment variables for the command. |
| cwd | string | Working directory for the command. |
| force_serial_tool_calls | boolean | Run this server's tool calls one at a time. |
List MCP servers
GET /mcp-servers
Returns a PaginatedResponse of MCP servers.
Get an MCP server
GET /mcp-servers/{mcp_server_id}
Returns a single PublicMcpServer.
Create an MCP server
POST /mcp-servers
Registers a new MCP server. Provide the connection details for the server's transport — url/headers for a remote server, or command/args/env/cwd for a local one.
Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Display name. |
| transport | string | No | Transport type. |
| url | string | No | Endpoint URL (remote). |
| headers | object | No | Request headers (remote). |
| command | string | No | Executable (local stdio). |
| args | array | No | Command arguments. |
| env | object | No | Command environment variables. |
| cwd | string | No | Command working directory. |
| force_serial_tool_calls | boolean | No | Serialize this server's tool calls. |
| type / icon / organization_type | string | No | Display and categorization metadata. |
| oauth_client_config | object | No | OAuth client config for servers that act on a user's behalf. |
curl -X POST 'https://{your-deployment-host}/tenants/{tenant-id}/api/v2/mcp-servers' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "Weather",
"transport": "streamable-http",
"url": "https://mcp.example.com/weather"
}'Returns the created PublicMcpServer.
Update an MCP server
PUT /mcp-servers/{mcp_server_id}
Updates a server. Takes the same body as create. Returns the updated PublicMcpServer.
Delete an MCP server
DELETE /mcp-servers/{mcp_server_id}
Deletes a server. Returns 204 No Content.