RealtimeMCPToolCall interface

Package:

@azure/ai-projects

A Realtime item representing an invocation of a tool on an MCP server.

Extends

RealtimeConversationItem

Properties

approval_request_id	The identifier of the approval request associated with this tool invocation, when one was required.
arguments	A JSON string of the arguments passed to the tool.
created_at	The Unix timestamp (in seconds) for when the item was persisted.
error	Details of a protocol, HTTP, or tool execution failure associated with this invocation.
id	The unique ID of the tool call.
name	The name of the tool that was run.
output	The result returned by the invoked MCP tool.
response_id	The id of the response that produced this item, when applicable.
server_label	The label of the MCP server running the tool.
type	The type of the item. Always mcp_call.

Property Details

approval_request_id

The identifier of the approval request associated with this tool invocation, when one was required.

approval_request_id?: string

Property Value

string

arguments

A JSON string of the arguments passed to the tool.

arguments: string

Property Value

string

created_at

The Unix timestamp (in seconds) for when the item was persisted.

created_at?: Date

Property Value

Date

error

Details of a protocol, HTTP, or tool execution failure associated with this invocation.

error?: RealtimeMCPErrorUnion

Property Value

RealtimeMCPErrorUnion

id

The unique ID of the tool call.

id: string

Property Value

string

name

The name of the tool that was run.

name: string

Property Value

string

output

The result returned by the invoked MCP tool.

output?: string

Property Value

string

response_id

The id of the response that produced this item, when applicable.

response_id?: string

Property Value

string

server_label

The label of the MCP server running the tool.

server_label: string

Property Value

string

type

The type of the item. Always mcp_call.

type: "mcp_call"

Property Value

"mcp_call"