Create or update an MCP connection with the given ID. If the connection exists and mcpUrl matches, updates name/metadata/headers. Returns 409 if mcpUrl differs - delete and recreate to change URL. Requires API key and namespace ownership.
Smithery API key as Bearer token
URL of the MCP server
"https://mcp.example.com/sse"
Human-readable name (optional, defaults to connection ID)
1 - 255"My MCP Server"
Custom metadata for filtering connections
{
"userId": "user123",
"team": "engineering"
}Custom headers to send with MCP requests (stored securely, not returned in responses)
{ "X-API-Key": "secret-key" }Connection updated
Connection ID (auto-generated or developer-defined)
"clever-dolphin-a9X3"
Human-readable name
MCP server URL
ISO 8601 timestamp
Last known connection status
Server information from MCP initialization (name, version)