MCPToolInput
Tool authoring fields. Omitted fields retain existing values. New tools require a name; publish requires valid source and description.
nameStringStable lowercase name. Renaming requires replacement.
titleStringHuman-readable tool title.
descriptionStringInstructions explaining when and how to use this tool.
sourceStringTool-owned Lua source defining exports.handler(input).
inputAnnotationsStringJSON Pointer keyed metadata for inferred inputs; structural keywords are forbidden.
outputAnnotationsStringJSON Pointer keyed metadata for inferred outputs; structural keywords are forbidden.
enabledBooleanWhether assigned callers can discover and invoke the published tool.
publishedBooleanPublish this exact authored definition, or false to withdraw publication.
readOnlyBooleanClient hint; does not enforce read-only execution.
destructiveBooleanClient hint describing destructive effects.
idempotentBooleanClient hint describing repeat-call behavior.
openWorldBooleanClient hint indicating interaction with external systems.
Direct user assignments. An empty array clears assignments.
Team assignments. An empty array clears assignments.
expectedRevisionStringCurrent 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.