Sign in
connect

Create connection

Create a new MCP connection with an auto-generated ID. Requires API key and namespace ownership.

post/connect/{namespace}

Path parameters

namespacestring required

Request body

mcpUrlstring uri required

URL of the MCP server

namestring

Human-readable name (optional, defaults to connection ID)

metadataobject

Custom metadata for filtering connections

headersobject

Custom headers to send with MCP requests (stored securely, not returned in responses)

Example request

{
  "mcpUrl": "https://mcp.example.com/sse",
  "name": "My MCP Server",
  "metadata": {
    "userId": "user123",
    "team": "engineering"
  },
  "headers": {
    "X-API-Key": "secret-key"
  }
}

Response

Connection created

connectionIdstring required

Connection ID (auto-generated or developer-defined)

namestring required

Human-readable name

mcpUrlstring required

MCP server URL

metadataobject nullable required
iconUrlstring nullable
createdAtstring

ISO 8601 timestamp

Example response

{
  "connectionId": "clever-dolphin-a9X3"
}

Changes