Add an MCP server

Add an MCP server that your assistants can use during a call. Authenticate with the headers the server expects, such as an API key or a bearer token you obtained from its provider; the platform stores them encrypted and sends them with every request. Then attach the server to an assistant with a tool of type mcp in llm_config.tools.

The URL must use https:// and resolve to a public address.

Authorization

BearerAuth

AuthorizationBearer <token>

API key authentication. Get your key from the dashboard.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Display name, unique within your organization

Length1 <= length <= 100

url*string

The server's endpoint. Must use https:// and resolve to a public address; addresses on private, loopback or link-local networks are rejected. Put credentials in headers, not in the URL.

Formaturi

Lengthlength <= 2048

transport?string

streamable_http for current MCP servers. Use sse only for a server that offers nothing else.

Default"streamable_http"

Value in"streamable_http" | "sse"

headers?

Header names and values sent with every request to the MCP server, typically an API key or a bearer token that you obtained from the server's provider. At most 10 headers. A name is an HTTP token; Host, Content-Type, Content-Length, Transfer-Encoding, Connection, Accept, Accept-Encoding, Mcp-Session-Id, Mcp-Protocol-Version and Last-Event-Id are set by the platform and cannot be set here. A value is a non-empty string of at most 8192 characters without line breaks.

Propertiesproperties <= 10

timeout_seconds?integer

How long the platform waits for the server on each request, including a tool call during a conversation.

Default20

Range5 <= value <= 60

Response Body

`application/json`

curl -X POST "https://example.com/mcp-servers" \  -H "Content-Type: application/json" \  -d '{    "name": "Mailbox",    "url": "https://mcp.example.com/mcp"  }'

{
  "mcp_server": {
    "id": "2f1c9a7e-4b3d-4e8a-9c21-6d5f0b7a8e13",
    "name": "Mailbox",
    "url": "https://mcp.example.com/mcp",
    "transport": "streamable_http",
    "header_names": [
      "Authorization"
    ],
    "timeout_seconds": 20,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}

{
  "error": "Invalid API key",
  "message": "string"
}

{
  "error": "Invalid API key",
  "message": "string"
}

{
  "error": "Invalid API key",
  "message": "string"
}

Add an MCP server

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

409application/json

`application/json`

`application/json`

`application/json`

`application/json`