message_complete_notification

Signal completion of tasks or responses by sending cross-platform notifications to users. Use this tool once per message to indicate when work is finished.

Instructions

Input Schema

TableJSON Schema

Name	Required	Description	Default
`projectName`	Yes	Notification title
`message`	Yes	Notification body

Implementation Reference

src/index.ts:162-174 (handler)

The handler function for the 'message_complete_notification' tool. It extracts projectName and message from input args, sends a desktop notification using node-notifier, and returns a confirmation message.

(args) => {
  // Use inferred args type
  const { projectName, message } = args;
  notifier.notify({ title: projectName, message });
  return {
    content: [
      {
        type: 'text',
        text: 'Notification sent. You can now wait for user input.',
      },
    ],
  };
},

src/index.ts:153-176 (registration)

The registration of the tool handler using server.tool(), conditionally based on tool enablement. Includes dynamic description resolution and schema from the tool definition.

if (isToolEnabled('message_complete_notification')) {
  // Use properties from the imported tool object
  server.tool(
    'message_complete_notification',
    // Description is a string here, but handle consistently
    typeof messageCompleteNotificationTool.description === 'function'
      ? messageCompleteNotificationTool.description(globalTimeoutSeconds) // Should not happen based on definition, but safe
      : messageCompleteNotificationTool.description,
    messageCompleteNotificationTool.schema, // Use schema property
    (args) => {
      // Use inferred args type
      const { projectName, message } = args;
      notifier.notify({ title: projectName, message });
      return {
        content: [
          {
            type: 'text',
            text: 'Notification sent. You can now wait for user input.',
          },
        ],
      };
    },
  );
}

src/tool-definitions/message-complete-notification.ts:66-69 (schema)
Zod schema (raw shape) defining the input parameters: projectName and message, used for validation in the tool registration.
```
const rawSchema: ZodRawShape = {
  projectName: z.string().describe('Notification title'),
  message: z.string().describe('Notification body'),
};
```

src/tool-definitions/message-complete-notification.ts:9-26 (schema)

JSON Schema in ToolCapabilityInfo defining the tool's parameters and description for MCP protocol capability declaration.

const capabilityInfo: ToolCapabilityInfo = {
  description: 'Notify when a response has completed via OS notification.',
  parameters: {
    type: 'object',
    properties: {
      projectName: {
        type: 'string',
        description:
          'Identifies the context/project making the notification (appears in notification title)',
      },
      message: {
        type: 'string',
        description: 'The specific notification text (appears in the body)',
      },
    },
    required: ['projectName', 'message'],
  },
};

src/tool-definitions/message-complete-notification.ts:72-76 (registration)
Export of the ToolDefinition object combining capability, description, and schema, imported and used in index.ts for registration.
```
export const messageCompleteNotificationTool: ToolDefinition = {
  capability: capabilityInfo,
  description: registrationDescription,
  schema: rawSchema, // Use the raw shape here
};
```

Interactive MCP