Orchestrations

Create Orchestration Mcp Server

POST/v2/orchestrations/{orchestration_id}/mcp-servers

Define a new orchestration-level MCP server. Composition by name is resolved on each member at bootstrap: a reserved built-in wins first, then the agent's own server of that name (an enabled one overrides this definition, a disabled one suppresses it), then this inherited definition. The inherited definition is never copied onto a member's own agent config.

Path Parameters

orchestration_idstring · uuidrequired

Request Body

namestringrequired

urlstringoptional

commandstringoptional

argsarray<string>optional

envobjectoptional

headersobjectoptional

is_enabledbooleanoptional

iconstringoptional

icon_colorstringoptional

Request

curl --request POST \
  --url https://api.brainbaselabs.com/v2/orchestrations/{orchestration_id}/mcp-servers \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "string",
  "url": null,
  "command": null,
  "args": [
    "string"
  ],
  "env": {
    "property1": "string",
    "property2": "string"
  },
  "headers": {
    "property1": "string",
    "property2": "string"
  },
  "is_enabled": true,
  "icon": null,
  "icon_color": null
}'

Response

json

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "url": null,
  "command": null,
  "args": [
    "string"
  ],
  "is_enabled": true,
  "icon": null,
  "icon_color": null,
  "env_keys": [
    "string"
  ],
  "headers_keys": [
    "string"
  ],
  "env_refs": {
    "property1": "string",
    "property2": "string"
  },
  "headers_refs": {
    "property1": "string",
    "property2": "string"
  },
  "created_at": null,
  "updated_at": null
}