← All types
In Input object

MCPToolInput

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

Fields

name

StringOptional

Stable lowercase name. Renaming requires replacement.

title

StringOptional

Human-readable tool title.

Instructions explaining when and how to use this tool.

source

StringOptional

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.

Whether assigned callers can discover and invoke the published tool.

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

Declared by the tool's author: the tool only reads. Not enforced; the Today assistant may run such a tool without asking, and the run is recorded.

Client hint describing destructive effects.

Client hint describing repeat-call behavior.

Client hint indicating interaction with external systems.

userIds

[UserID!]Optional

Direct user assignments. An empty array clears assignments.

teamIds

[TeamID!]Optional

Team assignments. An empty array clears assignments.

Current observed revision, required when updating an existing tool.

Referenced by (3)
Exact type 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
  """
  Declared by the tool's author: the tool only reads. Not enforced; the Today assistant may run such a tool without asking, and the run is recorded.
  """
  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
}