← API reference
CANONICAL TYPE REFERENCE

MCPToolInput

Tool authoring fields. Omitted fields retain existing values. New tools require a name; publish requires valid source and description.

nameString

Stable lowercase name. Renaming requires replacement.

titleString

Human-readable tool title.

Instructions explaining when and how to use this tool.

sourceString

Tool-owned Lua source defining exports.handler(input).

JSON Pointer keyed metadata for inferred inputs; structural keywords are forbidden.

JSON Pointer keyed metadata for inferred outputs; structural keywords are forbidden.

enabledBoolean

Whether assigned callers can discover and invoke the published tool.

publishedBoolean

Publish this exact authored definition, or false to withdraw publication.

readOnlyBoolean

Client hint; does not enforce read-only execution.

Client hint describing destructive effects.

idempotentBoolean

Client hint describing repeat-call behavior.

openWorldBoolean

Client hint indicating interaction with external systems.

Direct user assignments. An empty array clears assignments.

Team assignments. An empty array clears assignments.

Current observed revision, required when updating an existing tool.

View exact SDL
"""
Tool authoring fields. Omitted fields retain existing values. New tools require a name; publish requires valid source and description.
"""
input MCPToolInput {
  """Stable lowercase name. Renaming requires replacement."""
  name: String
  """Human-readable tool title."""
  title: String
  """Instructions explaining when and how to use this tool."""
  description: String
  """Tool-owned Lua source defining exports.handler(input)."""
  source: String
  """
  JSON Pointer keyed metadata for inferred inputs; structural keywords are forbidden.
  """
  inputAnnotations: String
  """
  JSON Pointer keyed metadata for inferred outputs; structural keywords are forbidden.
  """
  outputAnnotations: String
  """Whether assigned callers can discover and invoke the published tool."""
  enabled: Boolean
  """
  Publish this exact authored definition, or false to withdraw publication.
  """
  published: Boolean
  """Client hint; does not enforce read-only execution."""
  readOnly: Boolean
  """Client hint describing destructive effects."""
  destructive: Boolean
  """Client hint describing repeat-call behavior."""
  idempotent: Boolean
  """Client hint indicating interaction with external systems."""
  openWorld: Boolean
  """Direct user assignments. An empty array clears assignments."""
  userIds: [UserID!]
  """Team assignments. An empty array clears assignments."""
  teamIds: [TeamID!]
  """Current observed revision, required when updating an existing tool."""
  expectedRevision: String
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.