openai · OpenAI Platform Docs
Realtime with tools
Teaches how to integrate function tools, Model Context Protocol (MCP) tools, and built-in connectors into a Realtime API session to enable model-driven actions and data retrieval.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Realtime with tools
Teaches how to integrate function tools, Model Context Protocol (MCP) tools, and built-in connectors into a Realtime API session to enable model-driven actions and data retrieval.
When To Use
Use when you need to enable a Realtime model to execute application logic, connect to remote MCP servers, or access third-party services like Google Calendar during a live conversation.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/realtime-with-tools-workflow-guide.md | A guide explaining how to configure function tools and Model Context Protocol (MCP) tools for Realtime API sessions. | Questions about a guide explaining how to configure function tools and Model Context Protocol (MCP) tools for Realtime API sessions. |
examples/realtime-with-tools-openai-realtime-mcp-javascript-session-update-tools.javascript | A JavaScript code snippet demonstrating how to configure session update events with function tool definitions for the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A JavaScript code snippet demonstrating how to configure session update events with function tool definitions for the... |
examples/realtime-with-tools-openai-realtime-mcp-python-tool-use.python | A Python code example demonstrating how to implement tool calling within an OpenAI Realtime session using the Model Context Protocol. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to implement tool calling within an OpenAI Realtime session using the Model C... |
examples/realtime-with-tools-openai-realtime-mcp-javascript-function-call.javascript | A JavaScript example demonstrating how to send a function call output event via a WebSocket connection in the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A JavaScript example demonstrating how to send a function call output event via a WebSocket connection in the OpenAI... |
examples/realtime-with-tools-openai-realtime-mcp-python-function-call.python | A Python code example demonstrating how to send a function call output event and trigger a response in the OpenAI Realtime API using MCP. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to send a function call output event and trigger a response in the OpenAI Rea... |
examples/realtime-with-tools-openai-realtime-mcp-session-update.javascript | A JavaScript code snippet demonstrating how to configure a Realtime session with Model Context Protocol (MCP) tools via a session update event. | Exact payloads, commands, or snippets shown in A JavaScript code snippet demonstrating how to configure a Realtime session with Model Context Protocol (MCP) tools v... |
examples/realtime-with-tools-openai-realtime-mcp-tools-python-session-update.python | A Python code snippet demonstrating how to configure a realtime session with Model Context Protocol (MCP) tools via a session update event. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to configure a realtime session with Model Context Protocol (MCP) tools via a... |
examples/realtime-with-tools-openai-realtime-mcp-tools-javascript-session-update.javascript | A JavaScript code snippet demonstrating how to configure a realtime session with Model Context Protocol (MCP) tools via a session update event. | Exact payloads, commands, or snippets shown in A JavaScript code snippet demonstrating how to configure a realtime session with Model Context Protocol (MCP) tools v... |
examples/realtime-with-tools-openai-realtime-mcp-python-session-update-event.python | A Python code snippet demonstrating a session update event configuration for using Model Context Protocol tools within the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating a session update event configuration for using Model Context Protocol tools withi... |
examples/realtime-with-tools-openai-realtime-mcp-javascript-event-parsing.javascript | A JavaScript function implementation for parsing raw realtime event messages and extracting content from message items. | Exact payloads, commands, or snippets shown in A JavaScript function implementation for parsing raw realtime event messages and extracting content from message items. |
examples/realtime-with-tools-openai-realtime-mcp-tools.python | A Python implementation demonstrating how to handle Model Context Protocol tool events within an OpenAI Realtime API session. | Exact payloads, commands, or snippets shown in A Python implementation demonstrating how to handle Model Context Protocol tool events within an OpenAI Realtime API... |
examples/realtime-with-tools-openai-realtime-mcp-approval.javascript | A JavaScript function demonstrating how to send an mcpapprovalresponse event via WebSocket to approve a Model Context Protocol request. | Exact payloads, commands, or snippets shown in A JavaScript function demonstrating how to send an mcpapprovalresponse event via WebSocket to approve a Model Context... |
examples/realtime-with-tools-openai-realtime-mcp-tool-approval.python | A Python implementation demonstrating how to handle and approve Model Context Protocol (MCP) requests within a Realtime API session. | Exact payloads, commands, or snippets shown in A Python implementation demonstrating how to handle and approve Model Context Protocol (MCP) requests within a Realti... |
examples/realtime-with-tools-openai-realtime-mcp-tools.javascript | A JavaScript code example demonstrating how to implement Model Context Protocol (MCP) tools within the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A JavaScript code example demonstrating how to implement Model Context Protocol (MCP) tools within the OpenAI Realtim... |
examples/realtime-with-tools-openai-realtime-mcp.python | A Python code example demonstrating how to use the Realtime API with Model Context Protocol (MCP) tools. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to use the Realtime API with Model Context Protocol (MCP) tools. |
examples/realtime-with-tools-openai-realtime-mcp-javascript-tool-use.javascript | A JavaScript code example demonstrating how to trigger a response using the Model Context Protocol (MCP) within the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A JavaScript code example demonstrating how to trigger a response using the Model Context Protocol (MCP) within the O... |
examples/realtime-with-tools-openai-realtime-mcp-python-tool-use-2.python | A Python code example demonstrating how to use the Model Context Protocol (MCP) with the OpenAI Realtime API to trigger tool calls. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to use the Model Context Protocol (MCP) with the OpenAI Realtime API to trigg... |
What This Skill Covers
- You can attach tools to a Realtime session so the model can look up data, take actions, or call services during a live conversation. Tool configuration uses...
- Main sections:
Choose a tool type,Configure a function tool,Configure an MCP tool,Realtime MCP flow,Common failures.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.openai.com/api/docs/guides/realtime-mcp.md