OptionalallowedList of allowed tool names or a filter object. Use this to limit which tools from the MCP server are available to the model.
OptionalauthorizationAn OAuth access token for authentication with the MCP server. Your application must handle the OAuth authorization flow and provide the token here.
Identifier for the service connector. These are OpenAI-maintained MCP wrappers for popular services.
Available connectors:
connector_dropbox: Dropbox file accessconnector_gmail: Gmail email accessconnector_googlecalendar: Google Calendar accessconnector_googledrive: Google Drive file accessconnector_microsoftteams: Microsoft Teams accessconnector_outlookcalendar: Outlook Calendar accessconnector_outlookemail: Outlook Email accessconnector_sharepoint: SharePoint file accessOptionalheadersOptional HTTP headers to send to the MCP server. Use for authentication or other purposes.
OptionalrequireSpecify which of the MCP server's tools require approval before execution.
"always": All tools require approval"never": No tools require approvalMcpApprovalFilter: Fine-grained control over which tools require approvalOptionalserverOptional description of the MCP server, used to provide more context to the model.
A label for this MCP server, used to identify it in tool calls.
Options for connecting to an OpenAI-maintained service connector.