← All resources

Resource

mcp_tool

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

GraphQL reference →

Configuration

nameString!Optional

Stable lowercase name. Renaming requires replacement.

forces replacement

titleString!Optional

Human-readable tool title.

descriptionString!Optional

Instructions explaining when and how to use this tool.

sourceString!Optional

Tool-owned Lua source defining exports.handler(input).

inputAnnotationsString!Optional

JSON Pointer keyed metadata for inferred inputs; structural keywords are forbidden.

outputAnnotationsString!Optional

JSON Pointer keyed metadata for inferred outputs; structural keywords are forbidden.

enabledBoolean!Optional

Whether assigned callers can discover and invoke the published tool.

publishedBoolean!Optional

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

readOnlyBoolean!Optional

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.

destructiveBoolean!Optional

Client hint describing destructive effects.

idempotentBoolean!Optional

Client hint describing repeat-call behavior.

openWorldBoolean!Optional

Client hint indicating interaction with external systems.

userIds[UserID!]!Optional

Direct user assignments. An empty array clears assignments.

References service_account

teamIds[TeamID!]!Optional

Team assignments. An empty array clears assignments.

References team

Read-only values

Show values
idMCPToolID!Read only

Tool identity.

computed by the platform

inputSchemaStringRead only

Server-generated inputSchema.

computed by the platform

outputSchemaStringRead only

Server-generated outputSchema.

computed by the platform

revisionString!Read only

Server-generated revision.

computed by the platform

publishedVersionIdMCPToolVersionIDRead only

Server-generated publishedVersionId.

computed by the platform

createdAtString!Read only

Server-generated createdAt.

computed by the platform

updatedAtString!Read only

Server-generated updatedAt.

computed by the platform

Lifecycle

The CLI can create this resource. The platform assigns its id.

When replacement is needed, the existing resource is removed before its replacement is created.