← All types
Ob Object

MCPTool

Tenant-defined Lua tool with assignment-scoped MCP invocation.

Fields

id

MCPToolID!Non-null

Tool identity.

name

String!Non-null

Stable lowercase name. Renaming requires replacement.

title

String!Non-null

Human-readable tool title.

Instructions explaining when and how to use this tool.

source

String!Non-null

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!]!Non-null

Direct user assignments. An empty array clears assignments.

teamIds

[TeamID!]!Non-null

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
}