MCPToolInput
Tool authoring fields. Omitted fields retain existing values. New tools require a name; publish requires valid source and description.
Fields
Stable lowercase name. Renaming requires replacement.
Human-readable tool title.
Instructions explaining when and how to use this tool.
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.
Direct user assignments. An empty array clears assignments.
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
}