← All types
Ob Object

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.

tool

MyMCPTool!Non-null

The tool as published when the run was requested.

input

JSON!Non-null

Arguments the tool was given.

Where the run stands.

Possible values (4)
RUNNING

Still running: returned to a repeated request while the first one runs. Read the outcome later with myMCPToolInvocations.

SUCCEEDED

The tool ran and returned its output.

FAILED

The tool ran and failed, was cancelled, or was interrupted; see error.

REFUSED

Not run: the tool was republished or the input no longer matches its form since the request was prepared.

output

JSONNullable

The tool's result; null unless SUCCEEDED.

error

StringNullable

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
}