Set MCP configuration

Adds or updates MCP server entries for the workspace. Existing servers not included in the payload are preserved unchanged.

For each server entry in the payload, if headers is omitted or null and a server with the same id (or mcp_url) already exists, the stored header values are preserved. To explicitly clear all headers for a server, pass headers: {}. Returns the first saved server entry with its stable ID.

Adds or updates MCP server entries for the workspace. Existing servers not included in the payload are preserved unchanged. For each server entry in the payload, if `headers` is omitted or `null` and a server with the same `id` (or `mcp_url`) already exists, the stored header values are preserved. To explicitly clear all headers for a server, pass `headers: {}`. Returns the first saved server entry with its stable ID.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

workspace_idstringRequired

Request

This endpoint expects an object.

serverslist of objectsRequired

List of MCP server configurations

Response

MCP configuration set successfully

idstring

Stable config ID for linking actions to this server entry

mcp_urlstringformat: "uri"

The HTTPS URL of the MCP server (SSE endpoint)

has_headersboolean

Whether custom headers are stored in Vault

headers_keyslist of strings

Names of stored header keys (values redacted)

Errors

400

Bad Request Error

$	curl -X POST https://api.synthflow.ai/v2/workspaces/1727192238961x413997613917405200/mcp-config \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"servers": [
>	{
>	"mcp_url": "https://mcp.synthflow.ai/sse"
>	}
>	]
>	}'

1	{
2	"id": "mcp-9876543210abcdef",
3	"mcp_url": "https://mcp.synthflow.ai/sse",
4	"has_headers": true,
5	"headers_keys": [
6	"Authorization",
7	"X-Api-Key"
8	]
9	}