openai · OpenAI Platform Docs
Realtime with tools | OpenAI API
Teaches how to integrate external tools and functions into the OpenAI Realtime API to enable the model to perform actions during a live session.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Realtime with tools | OpenAI API
Teaches how to integrate external tools and functions into the OpenAI Realtime API to enable the model to perform actions during a live session.
When To Use
Use when you need to enable a Realtime API session to call external functions or interact with third-party tools during a voice or text conversation.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/realtime-with-tools-openai-api-workflow-guide.md | A guide explaining how to configure function tools and Model Context Protocol (MCP) tools within an OpenAI Realtime API session. | Questions about a guide explaining how to configure function tools and Model Context Protocol (MCP) tools within an OpenAI Realtime A... |
examples/realtime-with-tools-openai-api-openai-realtime-session-update-tools-conf.text | A session update event configuration defining tool definitions and function parameters for the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A session update event configuration defining tool definitions and function parameters for the OpenAI Realtime API. |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-session-update-tools-.text | A JSON object representing a session update event that configures function tools for the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A JSON object representing a session update event that configures function tools for the OpenAI Realtime API. |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-function-call-event.text | A text representation of a WebSocket event used to send a function call output back to the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A text representation of a WebSocket event used to send a function call output back to the OpenAI Realtime API. |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-function-call-event-2.text | A JSON event structure demonstrating a conversation.item.create event containing a function call output for the Realtime API. | Exact payloads, commands, or snippets shown in A JSON event structure demonstrating a conversation.item.create event containing a function call output for the Realt... |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-session-update-event.text | A JSON-formatted session update event configuration for the OpenAI Realtime API demonstrating Model Context Protocol (MCP) tool integration. | Exact payloads, commands, or snippets shown in A JSON-formatted session update event configuration for the OpenAI Realtime API demonstrating Model Context Protocol... |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-session-update-event-2.text | A JSON object representing a session.update event configured with MCP tools for the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A JSON object representing a session.update event configured with MCP tools for the OpenAI Realtime API. |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-session-update-config.text | A JSON-formatted session update configuration demonstrating how to integrate Model Context Protocol (MCP) tools like Google Calendar into an OpenAI Realtime API session. | Exact payloads, commands, or snippets shown in A JSON-formatted session update configuration demonstrating how to integrate Model Context Protocol (MCP) tools like... |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-session-update-event-3.text | A JSON-formatted session update event demonstrating how to configure Model Context Protocol (MCP) tools within an OpenAI Realtime API session. | Exact payloads, commands, or snippets shown in A JSON-formatted session update event demonstrating how to configure Model Context Protocol (MCP) tools within an Ope... |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-event-parsing-javascr.text | A JavaScript function demonstrating how to parse raw realtime event messages into JSON objects. | Exact payloads, commands, or snippets shown in A JavaScript function demonstrating how to parse raw realtime event messages into JSON objects. |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-tools-list-python.text | A Python code snippet demonstrating how to handle the mcplisttools.inprogress event type when listing MCP tools in the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to handle the mcplisttools.inprogress event type when listing MCP tools in th... |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-approve-request-javas.text | A JavaScript function demonstrating how to send a conversation.item.create event to approve an MCP request via a WebSocket connection. | Exact payloads, commands, or snippets shown in A JavaScript function demonstrating how to send a conversation.item.create event to approve an MCP request via a WebS... |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-approval-python.text | A Python function demonstrating how to send an mcpapprovalresponse event via a websocket to approve an MCP request. | Exact payloads, commands, or snippets shown in A Python function demonstrating how to send an mcpapprovalresponse event via a websocket to approve an MCP request. |
examples/realtime-with-tools-openai-api-openai-realtime-api-mcp-tool-response-cre.text | A JSON event object demonstrating a response.create request containing an MCP tool definition for the Realtime API. | Exact payloads, commands, or snippets shown in A JSON event object demonstrating a response.create request containing an MCP tool definition for the Realtime API. |
examples/realtime-with-tools-openai-api-openai-realtime-api-mcp-response-create-e.text | A JSON event object demonstrating a response.create request with MCP tool integration for the OpenAI Realtime API. | Exact payloads, commands, or snippets shown in A JSON event object demonstrating a response.create request with MCP tool integration for the OpenAI Realtime API. |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-response-create-event.text | A JSON object representing a response.create event used to trigger tool calls within the OpenAI Realtime API using Model Context Protocol. | Exact payloads, commands, or snippets shown in A JSON object representing a response.create event used to trigger tool calls within the OpenAI Realtime API using Mo... |
examples/realtime-with-tools-openai-api-openai-realtime-mcp-response-create-event-2.text | A JSON event object demonstrating a response.create request to trigger tool use within the OpenAI Realtime API using MCP. | Exact payloads, commands, or snippets shown in A JSON event object demonstrating a response.create request to trigger tool use within the OpenAI Realtime API using... |
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