ApiMCP Servers

Update an MCP server

PATCH
/mcp-servers/{id}

Change an MCP server. Only the fields you send are changed. headers replaces all stored headers: leave it out to keep them, send {} to remove them. Use this to renew a token that expires. When url points to a different host (scheme, host or port) than before, send headers in the same request, {} if the new host needs none: stored headers never go to a new host, and without them the request is refused with 400. The change applies from the next call; calls in progress keep the connection they opened.

Authorization

BearerAuth
AuthorizationBearer <token>

API key authentication. Get your key from the dashboard.

In: header

Path Parameters

id*string

MCP server UUID

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/mcp-servers/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{
  "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"
}
{
  "error": "Invalid API key",
  "message": "string"
}

Add an MCP server POST

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.

Delete an MCP server DELETE

Delete an MCP server and its stored headers. Deletion is refused with HTTP 409 while an assistant still uses the server, so no assistant loses a tool as a side effect. Remove the `mcp` tool from those assistants first.