Sign in

v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-305398191.8 KB
connect

Create or update connection

Create or update an MCP connection with the given ID. server is the Smithery registry qualified name; mcpUrl is for custom MCP URLs. One of them is required when creating a new HTTP connection, but optional when updating. Returns 409 if a different target URL is provided, except while the connection is input_required and the new URL keeps the same host and path.

put/{namespace}/{connectionId}

Path parameters

namespacestring required
connectionIdstring required

Request body

transport'http' | 'uplink'

Connection transport. Defaults to the existing connection transport when updating.

mcpUrlstring uri

URL of a custom MCP server. For Smithery registry servers, prefer server. Required with server omitted when creating a new HTTP connection; optional when updating.

serverstring

Smithery registry server qualified name. Use this instead of mcpUrl for registry servers.

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

{
  "transport": "http",
  "mcpUrl": "https://mcp.example.com/sse",
  "server": "upstash/context7-mcp",
  "name": "My MCP Server",
  "metadata": {
    "userId": "user123",
    "team": "engineering"
  },
  "headers": {
    "X-API-Key": "secret-key"
  },
  "mock": {
    "scenario": "Slack workspace with an active #community-ops channel containing recent event-planning messages, plus 50 Airtable candidate records with mixed tenure and interests."
  }
}

Response

Connection updated

connectionIdstring required

Connection ID (auto-generated or developer-defined)

namestring required

Human-readable name

transport'http' | 'uplink'

Connection transport

mcpUrlstring nullable required

MCP server URL. Null for uplink connections.

metadataobject nullable required
iconUrlstring nullable
createdAtstring

ISO 8601 timestamp

Example response

{
  "connectionId": "clever-dolphin-a9X3",
  "mock": {
    "scenario": "Slack workspace with an active #community-ops channel containing recent event-planning messages, plus 50 Airtable candidate records with mixed tenure and interests."
  }
}