Mu Mutation

invokeMCPTool

Topics: Scripting

Run an assigned tool as the caller and record the run. Any signed-in user; assignment is the grant. The tool's effects are real and are not rolled back.

Returns

MCPToolInvocationPayload!

Arguments

Tool to run; must be assigned to the caller, enabled and published.

Published version the request was prepared against; a newer one refuses the run.

input

JSON!Required

Arguments; must match the tool's input schema.

1–200 characters chosen by the caller per request; repeating it returns the first invocation without running again.

Exact field SDL
"""
Run an assigned tool as the caller and record the run. Any signed-in user; assignment is the grant. The tool's effects are real and are not rolled back.
"""
invokeMCPTool(
  """Tool to run; must be assigned to the caller, enabled and published."""
  toolId: MCPToolID!
  """
  Published version the request was prepared against; a newer one refuses the run.
  """
  toolVersionId: MCPToolVersionID!
  """Arguments; must match the tool's input schema."""
  input: JSON!
  """
  1–200 characters chosen by the caller per request; repeating it returns the first invocation without running again.
  """
  idempotencyKey: String!
): MCPToolInvocationPayload! @topic(names: ["scripting"])

Declared on Mutation. Access is checked by the platform for each operation.