chore(api): deprecate MCP connector_id

.castiron.stats.yml

@@ -1,8 +1,8 @@
 schema_version: 1
-generation_id: 69ad6cd7-573b-40b7-9762-941138a594fa
-openapi_spec_hash: 5866548478ad740b94e91012426f5fd9
-openapi_transformed_spec_hash: d8c09e5cfd1b7c8748feee9c5917f482
+generation_id: 5ca8ce21-7fe9-4009-836d-1c94c1c1e116
+openapi_spec_hash: 9530fc18efeeb0be58821616af20494d
+openapi_transformed_spec_hash: bcd481fc6089377839837e55cdfa80cc
 config_hash: 487f26152d0893506c0e0d1060441bd0
-codegen_sha: 3f38eecec718649bc81c416d513e1acb655a6d03
-codegen_hash: d3e2ebd89f88df3bc867b3f32cf7704168742fd26a59b9be459b654c1efefba7
-public_codegen_sha: 76d657bf37cecfc8aedbe9f0e495b57b79caaa2e
+codegen_sha: da44ef0149596e5412c15e70836dd015824a9a90
+codegen_hash: 838f201dfcf9313561fe25f2783c231d707b30a12cf93d0e54aec3687399b0ea
+public_codegen_sha: 8b18351582d0b9a4c85a147b4e8769630610fdeb

api_reference/openapi.transformed.yml

@@ -44340,6 +44340,7 @@ components:
             `tunnel_id` must be provided.
         connector_id:
           type: string
+          deprecated: true
           enum:
           - connector_dropbox
           - connector_gmail
@@ -44354,6 +44355,10 @@ components:
             `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more
             about service connectors [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+            This field is deprecated for models released after September 1, 2026.
+            Use `server_url` to connect to a remote MCP server, or `tunnel_id` to
+            connect through a Secure MCP Tunnel.
+
             Currently supported `connector_id` values are:
 
             - Dropbox: `connector_dropbox`
@@ -84014,6 +84019,7 @@ components:
             `tunnel_id` must be provided.
         connector_id:
           type: string
+          deprecated: true
           enum:
           - connector_dropbox
           - connector_gmail
@@ -84028,6 +84034,10 @@ components:
             `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more
             about service connectors [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+            This field is deprecated for models released after September 1, 2026.
+            Use `server_url` to connect to a remote MCP server, or `tunnel_id` to
+            connect through a Secure MCP Tunnel.
+
             Currently supported `connector_id` values are:
 
             - Dropbox: `connector_dropbox`

src/openai/types/beta/beta_tool.py

@@ -148,6 +148,10 @@ class Mcp(BaseModel):
     about service connectors
     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+    This field is deprecated for models released after September 1, 2026. Use
+    `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+    through a Secure MCP Tunnel.
+
     Currently supported `connector_id` values are:
 
     - Dropbox: `connector_dropbox`

src/openai/types/beta/beta_tool_param.py

@@ -147,6 +147,10 @@ class Mcp(TypedDict, total=False):
     about service connectors
     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+    This field is deprecated for models released after September 1, 2026. Use
+    `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+    through a Secure MCP Tunnel.
+
     Currently supported `connector_id` values are:
 
     - Dropbox: `connector_dropbox`

src/openai/types/realtime/realtime_response_create_mcp_tool.py

@@ -125,6 +125,10 @@ class RealtimeResponseCreateMcpTool(BaseModel):
     about service connectors
     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+    This field is deprecated for models released after September 1, 2026. Use
+    `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+    through a Secure MCP Tunnel.
+
     Currently supported `connector_id` values are:
 
     - Dropbox: `connector_dropbox`

src/openai/types/realtime/realtime_response_create_mcp_tool_param.py

@@ -125,6 +125,10 @@ class RealtimeResponseCreateMcpToolParam(TypedDict, total=False):
     about service connectors
     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+    This field is deprecated for models released after September 1, 2026. Use
+    `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+    through a Secure MCP Tunnel.
+
     Currently supported `connector_id` values are:
 
     - Dropbox: `connector_dropbox`

src/openai/types/realtime/realtime_session_create_response.py

@@ -347,6 +347,10 @@ class ToolMcpTool(BaseModel):
     about service connectors
     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+    This field is deprecated for models released after September 1, 2026. Use
+    `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+    through a Secure MCP Tunnel.
+
     Currently supported `connector_id` values are:
 
     - Dropbox: `connector_dropbox`

src/openai/types/realtime/realtime_tools_config_param.py

@@ -128,6 +128,10 @@ class Mcp(TypedDict, total=False):
     about service connectors
     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+    This field is deprecated for models released after September 1, 2026. Use
+    `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+    through a Secure MCP Tunnel.
+
     Currently supported `connector_id` values are:
 
     - Dropbox: `connector_dropbox`

src/openai/types/realtime/realtime_tools_config_union.py

@@ -128,6 +128,10 @@ class Mcp(BaseModel):
     about service connectors
     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+    This field is deprecated for models released after September 1, 2026. Use
+    `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+    through a Secure MCP Tunnel.
+
     Currently supported `connector_id` values are:
 
     - Dropbox: `connector_dropbox`

src/openai/types/realtime/realtime_tools_config_union_param.py

@@ -127,6 +127,10 @@ class Mcp(TypedDict, total=False):
     about service connectors
     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+    This field is deprecated for models released after September 1, 2026. Use
+    `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+    through a Secure MCP Tunnel.
+
     Currently supported `connector_id` values are:
 
     - Dropbox: `connector_dropbox`

src/openai/types/responses/tool.py

@@ -153,6 +153,10 @@ class Mcp(BaseModel):
     about service connectors
     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+    This field is deprecated for models released after September 1, 2026. Use
+    `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+    through a Secure MCP Tunnel.
+
     Currently supported `connector_id` values are:
 
     - Dropbox: `connector_dropbox`

src/openai/types/responses/tool_param.py

@@ -153,6 +153,10 @@ class Mcp(TypedDict, total=False):
     about service connectors
     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
 
+    This field is deprecated for models released after September 1, 2026. Use
+    `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+    through a Secure MCP Tunnel.
+
     Currently supported `connector_id` values are:
 
     - Dropbox: `connector_dropbox`