MCPToolInvocation
One run of an assigned tool by the caller. Visible only to the person who ran it.
Fields
Invocation identity.
The caller's key for this request; repeating it returns this invocation instead of running again.
Conversation whose assistant ran the tool; null for a person's own dispatch.
The tool as published when the run was requested.
Arguments the tool was given.
Where the run stands.
Possible values (4)
RUNNINGStill running: returned to a repeated request while the first one runs. Read the outcome later with myMCPToolInvocations.
SUCCEEDEDThe tool ran and returned its output.
FAILEDThe tool ran and failed, was cancelled, or was interrupted; see error.
REFUSEDNot run: the tool was republished or the input no longer matches its form since the request was prepared.
The tool's result; null unless SUCCEEDED.
Why it failed or was refused, in words safe to show the person; null otherwise.
When the run was requested.
When it finished; null while RUNNING.
Referenced by (2)
Exact type SDL
"""
One run of an assigned tool by the caller. Visible only to the person who ran it.
"""
type MCPToolInvocation {
"""Invocation identity."""
id: MCPToolInvocationID!
"""
The caller's key for this request; repeating it returns this invocation instead of running again.
"""
idempotencyKey: String!
"""
Conversation whose assistant ran the tool; null for a person's own dispatch.
"""
chatSessionId: ChatSessionID
"""The tool as published when the run was requested."""
tool: MyMCPTool!
"""Arguments the tool was given."""
input: JSON!
"""Where the run stands."""
status: MCPToolInvocationStatus!
"""The tool's result; null unless SUCCEEDED."""
output: JSON
"""
Why it failed or was refused, in words safe to show the person; null otherwise.
"""
error: String
"""When the run was requested."""
createdAt: ISO8601!
"""When it finished; null while RUNNING."""
finishedAt: ISO8601
}