MCPTool
Tenant-defined Lua tool with assignment-scoped MCP invocation.
Fields
Tool identity.
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.
Server-generated inputSchema.
Server-generated outputSchema.
Server-generated revision.
Server-generated publishedVersionId.
Server-generated createdAt.
Server-generated updatedAt.
Referenced by (3)
Exact type SDL
"""Tenant-defined Lua tool with assignment-scoped MCP invocation."""
type MCPTool @iac_resource(name: "mcp_tool") @iac_ops(create: "createMCPTool", read: "mcpTool", update: "updateMCPTool", delete: "deleteMCPTool") @iac_precondition(field: "revision", input: "expectedRevision") @iac_replace(strategy: DESTROY_BEFORE_CREATE) {
"""Tool identity."""
id: MCPToolID! @iac_identity(assignedBy: SERVER) @iac_computed
"""Stable lowercase name. Renaming requires replacement."""
name: String! @iac_forcesReplace
"""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! @iac_artifact(language: LUA, validators: ["lua-typecheck"])
"""
JSON Pointer keyed metadata for inferred inputs; structural keywords are forbidden.
"""
inputAnnotations: String! @iac_artifact(language: JSON)
"""
JSON Pointer keyed metadata for inferred outputs; structural keywords are forbidden.
"""
outputAnnotations: String! @iac_artifact(language: JSON)
"""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!]! @iac_ref(resource: "service_account")
"""Team assignments. An empty array clears assignments."""
teamIds: [TeamID!]! @iac_ref(resource: "team")
"""Server-generated inputSchema."""
inputSchema: String @iac_computed
"""Server-generated outputSchema."""
outputSchema: String @iac_computed
"""Server-generated revision."""
revision: String! @iac_computed
"""Server-generated publishedVersionId."""
publishedVersionId: MCPToolVersionID @iac_computed
"""Server-generated createdAt."""
createdAt: String! @iac_computed
"""Server-generated updatedAt."""
updatedAt: String! @iac_computed
}