Skip to content

An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.

feat: Add tool annotations for improved LLM tool understanding (#1543)

Bryan Thompson9a6fa1bd2ab3
diff --git a/.changeset/tool-annotations.md b/.changeset/tool-annotations.md
new file mode 100644
index 00000000..9ca19d9e
--- /dev/null
+++ b/.changeset/tool-annotations.md
@@ -0,0 +1,7 @@
+---
+"task-master-ai": patch
+---
+
+feat: Add tool annotations for improved LLM tool understanding
+
+Added MCP tool annotations (readOnlyHint, destructiveHint, title) to all 12 tools to help LLMs better understand tool behavior and make safer decisions about tool execution.
diff --git a/apps/mcp/src/tools/autopilot/abort.tool.ts b/apps/mcp/src/tools/autopilot/abort.tool.ts
index 29753d0e..972d9873 100644
--- a/apps/mcp/src/tools/autopilot/abort.tool.ts
+++ b/apps/mcp/src/tools/autopilot/abort.tool.ts
@@ -25,6 +25,10 @@ export function registerAutopilotAbortTool(server: FastMCP) {
description:
'Abort the current TDD workflow and clean up workflow state. This will remove the workflow state file but will NOT delete the git branch or any code changes.',
parameters: AbortSchema,
+ annotations: {
+ title: 'Abort Autopilot Workflow',
+ destructiveHint: true
+ },
execute: withToolContext(
'autopilot-abort',
async (args: AbortArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/autopilot/commit.tool.ts b/apps/mcp/src/tools/autopilot/commit.tool.ts
index a320f2ed..92579df0 100644
--- a/apps/mcp/src/tools/autopilot/commit.tool.ts
+++ b/apps/mcp/src/tools/autopilot/commit.tool.ts
@@ -36,6 +36,10 @@ export function registerAutopilotCommitTool(server: FastMCP) {
description:
'Create a git commit with automatic staging, message generation, and metadata embedding. Generates appropriate commit messages based on subtask context and TDD phase.',
parameters: CommitSchema,
+ annotations: {
+ title: 'Commit Autopilot Changes',
+ destructiveHint: true
+ },
execute: withToolContext(
'autopilot-commit',
async (args: CommitArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/autopilot/complete.tool.ts b/apps/mcp/src/tools/autopilot/complete.tool.ts
index d0f9977e..a301c3aa 100644
--- a/apps/mcp/src/tools/autopilot/complete.tool.ts
+++ b/apps/mcp/src/tools/autopilot/complete.tool.ts
@@ -33,6 +33,10 @@ export function registerAutopilotCompleteTool(server: FastMCP) {
description:
'Complete the current TDD phase (RED or GREEN) with test result validation. RED phase: expects failures (if 0 failures, feature is already implemented and subtask auto-completes). GREEN phase: expects all tests passing. For COMMIT phase, use autopilot_commit instead.',
parameters: CompletePhaseSchema,
+ annotations: {
+ title: 'Complete Autopilot Phase',
+ destructiveHint: true
+ },
execute: withToolContext(
'autopilot-complete-phase',
async (args: CompletePhaseArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/autopilot/finalize.tool.ts b/apps/mcp/src/tools/autopilot/finalize.tool.ts
index e7060158..347c018d 100644
--- a/apps/mcp/src/tools/autopilot/finalize.tool.ts
+++ b/apps/mcp/src/tools/autopilot/finalize.tool.ts
@@ -25,6 +25,10 @@ export function registerAutopilotFinalizeTool(server: FastMCP) {
description:
'Finalize and complete the workflow. Validates that all changes are committed and working tree is clean before marking workflow as complete.',
parameters: FinalizeSchema,
+ annotations: {
+ title: 'Finalize Autopilot Workflow',
+ destructiveHint: true
+ },
execute: withToolContext(
'autopilot-finalize',
async (args: FinalizeArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/autopilot/next.tool.ts b/apps/mcp/src/tools/autopilot/next.tool.ts
index 346dd9fc..216c82be 100644
--- a/apps/mcp/src/tools/autopilot/next.tool.ts
+++ b/apps/mcp/src/tools/autopilot/next.tool.ts
@@ -25,6 +25,10 @@ export function registerAutopilotNextTool(server: FastMCP) {
description:
'Get the next action to perform in the TDD workflow. Returns detailed context about what needs to be done next, including the current phase, subtask, and expected actions.',
parameters: NextActionSchema,
+ annotations: {
+ title: 'Get Next Autopilot Action',
+ readOnlyHint: true
+ },
execute: withToolContext(
'autopilot-next',
async (args: NextActionArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/autopilot/resume.tool.ts b/apps/mcp/src/tools/autopilot/resume.tool.ts
index 6f866834..5aade686 100644
--- a/apps/mcp/src/tools/autopilot/resume.tool.ts
+++ b/apps/mcp/src/tools/autopilot/resume.tool.ts
@@ -25,6 +25,10 @@ export function registerAutopilotResumeTool(server: FastMCP) {
description:
'Resume a previously started TDD workflow from saved state. Restores the workflow state machine and continues from where it left off.',
parameters: ResumeWorkflowSchema,
+ annotations: {
+ title: 'Resume Autopilot Workflow',
+ readOnlyHint: true
+ },
execute: withToolContext(
'autopilot-resume',
async (args: ResumeWorkflowArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/autopilot/start.tool.ts b/apps/mcp/src/tools/autopilot/start.tool.ts
index 0ae17e84..a5f4a063 100644
--- a/apps/mcp/src/tools/autopilot/start.tool.ts
+++ b/apps/mcp/src/tools/autopilot/start.tool.ts
@@ -39,6 +39,10 @@ export function registerAutopilotStartTool(server: FastMCP) {
description:
'Initialize and start a new TDD workflow for a task. Creates a git branch and sets up the workflow state machine.',
parameters: StartWorkflowSchema,
+ annotations: {
+ title: 'Start Autopilot Workflow',
+ destructiveHint: true
+ },
execute: withToolContext(
'autopilot-start',
async (args: StartWorkflowArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/autopilot/status.tool.ts b/apps/mcp/src/tools/autopilot/status.tool.ts
index be7fbf1c..836dca36 100644
--- a/apps/mcp/src/tools/autopilot/status.tool.ts
+++ b/apps/mcp/src/tools/autopilot/status.tool.ts
@@ -25,6 +25,10 @@ export function registerAutopilotStatusTool(server: FastMCP) {
description:
'Get comprehensive workflow status including current phase, progress, subtask details, and activity history.',
parameters: StatusSchema,
+ annotations: {
+ title: 'Get Autopilot Status',
+ readOnlyHint: true
+ },
execute: withToolContext(
'autopilot-status',
async (args: StatusArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/tasks/generate.tool.ts b/apps/mcp/src/tools/tasks/generate.tool.ts
index 8a014184..cfe5648e 100644
--- a/apps/mcp/src/tools/tasks/generate.tool.ts
+++ b/apps/mcp/src/tools/tasks/generate.tool.ts
@@ -33,6 +33,10 @@ export function registerGenerateTool(server: FastMCP) {
description:
'Generates individual task files in tasks/ directory based on tasks.json. Only works with local file storage.',
parameters: GenerateSchema,
+ annotations: {
+ title: 'Generate Task Files',
+ destructiveHint: true
+ },
execute: withToolContext(
'generate',
async (args: GenerateArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/tasks/get-task.tool.ts b/apps/mcp/src/tools/tasks/get-task.tool.ts
index 8c0ce884..8409fed0 100644
--- a/apps/mcp/src/tools/tasks/get-task.tool.ts
+++ b/apps/mcp/src/tools/tasks/get-task.tool.ts
@@ -38,6 +38,10 @@ export function registerGetTaskTool(server: FastMCP) {
name: 'get_task',
description: 'Get detailed information about a specific task',
parameters: GetTaskSchema,
+ annotations: {
+ title: 'Get Task',
+ readOnlyHint: true
+ },
execute: withToolContext(
'get-task',
async (args: GetTaskArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/tasks/get-tasks.tool.ts b/apps/mcp/src/tools/tasks/get-tasks.tool.ts
index dd6179b9..9cdd6d9f 100644
--- a/apps/mcp/src/tools/tasks/get-tasks.tool.ts
+++ b/apps/mcp/src/tools/tasks/get-tasks.tool.ts
@@ -40,6 +40,10 @@ export function registerGetTasksTool(server: FastMCP) {
description:
'Get all tasks from Task Master, optionally filtering by status and including subtasks.',
parameters: GetTasksSchema,
+ annotations: {
+ title: 'Get Tasks',
+ readOnlyHint: true
+ },
execute: withToolContext(
'get-tasks',
async (args: GetTasksArgs, { log, tmCore }: ToolContext) => {
diff --git a/apps/mcp/src/tools/tasks/set-task-status.tool.ts b/apps/mcp/src/tools/tasks/set-task-status.tool.ts
index 570c1784..73ae2d0a 100644
--- a/apps/mcp/src/tools/tasks/set-task-status.tool.ts
+++ b/apps/mcp/src/tools/tasks/set-task-status.tool.ts
@@ -34,6 +34,10 @@ export function registerSetTaskStatusTool(server: FastMCP) {
name: 'set_task_status',
description: 'Set the status of one or more tasks or subtasks.',
parameters: SetTaskStatusSchema,
+ annotations: {
+ title: 'Set Task Status',
+ destructiveHint: true
+ },
execute: withToolContext(
'set-task-status',
async (args: SetTaskStatusArgs, { log, tmCore }: ToolContext) => {
diff --git a/mcp-server/src/tools/add-dependency.js b/mcp-server/src/tools/add-dependency.js
index 712616fc..f5791468 100644
--- a/mcp-server/src/tools/add-dependency.js
+++ b/mcp-server/src/tools/add-dependency.js
@@ -33,6 +33,10 @@ export function registerAddDependencyTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Add Dependency',
+ destructiveHint: true
+ },
execute: withToolContext(
'add-dependency',
async (args, { log, session }) => {
diff --git a/mcp-server/src/tools/add-subtask.js b/mcp-server/src/tools/add-subtask.js
index 726ee596..c03c5065 100644
--- a/mcp-server/src/tools/add-subtask.js
+++ b/mcp-server/src/tools/add-subtask.js
@@ -62,6 +62,10 @@ export function registerAddSubtaskTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Add Subtask',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
const resolvedTag = resolveTag({
diff --git a/mcp-server/src/tools/add-tag.js b/mcp-server/src/tools/add-tag.js
index c02237db..70c67f19 100644
--- a/mcp-server/src/tools/add-tag.js
+++ b/mcp-server/src/tools/add-tag.js
@@ -50,6 +50,10 @@ export function registerAddTagTool(server) {
.string()
.describe('The directory of the project. Must be an absolute path.')
}),
+ annotations: {
+ title: 'Add Tag',
+ destructiveHint: false
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Starting add-tag with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/add-task.js b/mcp-server/src/tools/add-task.js
index 2a83a09a..35ec5a84 100644
--- a/mcp-server/src/tools/add-task.js
+++ b/mcp-server/src/tools/add-task.js
@@ -65,6 +65,10 @@ export function registerAddTaskTool(server) {
.optional()
.describe('Whether to use research capabilities for task creation')
}),
+ annotations: {
+ title: 'Add Task',
+ destructiveHint: false
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Starting add-task with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/analyze.js b/mcp-server/src/tools/analyze.js
index 80d24e5b..0e1e1bb3 100644
--- a/mcp-server/src/tools/analyze.js
+++ b/mcp-server/src/tools/analyze.js
@@ -75,6 +75,10 @@ export function registerAnalyzeProjectComplexityTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Analyze Project Complexity',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
const toolName = 'analyze_project_complexity'; // Define tool name for logging
diff --git a/mcp-server/src/tools/clear-subtasks.js b/mcp-server/src/tools/clear-subtasks.js
index 3da8a531..a669503e 100644
--- a/mcp-server/src/tools/clear-subtasks.js
+++ b/mcp-server/src/tools/clear-subtasks.js
@@ -39,6 +39,10 @@ export function registerClearSubtasksTool(server) {
message: "Either 'id' or 'all' parameter must be provided",
path: ['id', 'all']
}),
+ annotations: {
+ title: 'Clear Subtasks',
+ destructiveHint: true
+ },
execute: withToolContext('clear-subtasks', async (args, context) => {
try {
context.log.info(
diff --git a/mcp-server/src/tools/complexity-report.js b/mcp-server/src/tools/complexity-report.js
index b53b3e01..3942f4a5 100644
--- a/mcp-server/src/tools/complexity-report.js
+++ b/mcp-server/src/tools/complexity-report.js
@@ -33,6 +33,10 @@ export function registerComplexityReportTool(server) {
.string()
.describe('The directory of the project. Must be an absolute path.')
}),
+ annotations: {
+ title: 'Complexity Report',
+ readOnlyHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(
diff --git a/mcp-server/src/tools/copy-tag.js b/mcp-server/src/tools/copy-tag.js
index 0e53f180..bafde1d1 100644
--- a/mcp-server/src/tools/copy-tag.js
+++ b/mcp-server/src/tools/copy-tag.js
@@ -36,6 +36,10 @@ export function registerCopyTagTool(server) {
.string()
.describe('The directory of the project. Must be an absolute path.')
}),
+ annotations: {
+ title: 'Copy Tag',
+ destructiveHint: false
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Starting copy-tag with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/delete-tag.js b/mcp-server/src/tools/delete-tag.js
index 3a1c3862..81e28f62 100644
--- a/mcp-server/src/tools/delete-tag.js
+++ b/mcp-server/src/tools/delete-tag.js
@@ -34,6 +34,10 @@ export function registerDeleteTagTool(server) {
.string()
.describe('The directory of the project. Must be an absolute path.')
}),
+ annotations: {
+ title: 'Delete Tag',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Starting delete-tag with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/expand-all.js b/mcp-server/src/tools/expand-all.js
index 04ffed4b..9c8cf08d 100644
--- a/mcp-server/src/tools/expand-all.js
+++ b/mcp-server/src/tools/expand-all.js
@@ -64,6 +64,10 @@ export function registerExpandAllTool(server) {
),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Expand All Tasks',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(
diff --git a/mcp-server/src/tools/expand-task.js b/mcp-server/src/tools/expand-task.js
index c5037048..5018d2d8 100644
--- a/mcp-server/src/tools/expand-task.js
+++ b/mcp-server/src/tools/expand-task.js
@@ -52,6 +52,10 @@ export function registerExpandTaskTool(server) {
.describe('Force expansion even if subtasks exist'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Expand Task',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Starting expand-task with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/fix-dependencies.js b/mcp-server/src/tools/fix-dependencies.js
index 268c1e06..a2b982f4 100644
--- a/mcp-server/src/tools/fix-dependencies.js
+++ b/mcp-server/src/tools/fix-dependencies.js
@@ -24,6 +24,10 @@ export function registerFixDependenciesTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Fix Dependencies',
+ destructiveHint: true
+ },
execute: withToolContext('fix-dependencies', async (args, context) => {
try {
context.log.info(
diff --git a/mcp-server/src/tools/get-operation-status.js b/mcp-server/src/tools/get-operation-status.js
index 345029a6..e685370d 100644
--- a/mcp-server/src/tools/get-operation-status.js
+++ b/mcp-server/src/tools/get-operation-status.js
@@ -15,6 +15,10 @@ export function registerGetOperationStatusTool(server, asyncManager) {
parameters: z.object({
operationId: z.string().describe('The ID of the operation to check.')
}),
+ annotations: {
+ title: 'Get Operation Status',
+ readOnlyHint: true
+ },
execute: async (args, { log }) => {
try {
const { operationId } = args;
diff --git a/mcp-server/src/tools/initialize-project.js b/mcp-server/src/tools/initialize-project.js
index 3e3fc642..6a68787a 100644
--- a/mcp-server/src/tools/initialize-project.js
+++ b/mcp-server/src/tools/initialize-project.js
@@ -56,6 +56,10 @@ export function registerInitializeProjectTool(server) {
`List of rule profiles to include at initialization. If omitted, defaults to Cursor profile only. Available options: ${RULE_PROFILES.join(', ')}`
)
}),
+ annotations: {
+ title: 'Initialize Project',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, context) => {
const { log } = context;
const session = context.session;
diff --git a/mcp-server/src/tools/list-tags.js b/mcp-server/src/tools/list-tags.js
index 2e3c1163..fd2b885a 100644
--- a/mcp-server/src/tools/list-tags.js
+++ b/mcp-server/src/tools/list-tags.js
@@ -33,6 +33,10 @@ export function registerListTagsTool(server) {
.string()
.describe('The directory of the project. Must be an absolute path.')
}),
+ annotations: {
+ title: 'List Tags',
+ readOnlyHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Starting list-tags with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/models.js b/mcp-server/src/tools/models.js
index 4d886abe..7897984a 100644
--- a/mcp-server/src/tools/models.js
+++ b/mcp-server/src/tools/models.js
@@ -79,6 +79,10 @@ export function registerModelsTool(server) {
'Custom base URL for providers that support it (e.g., https://api.example.com/v1).'
)
}),
+ annotations: {
+ title: 'Models',
+ destructiveHint: true
+ },
execute: withToolContext('models', async (args, context) => {
try {
context.log.info(
diff --git a/mcp-server/src/tools/move-task.js b/mcp-server/src/tools/move-task.js
index 3fee1696..0c887ce6 100644
--- a/mcp-server/src/tools/move-task.js
+++ b/mcp-server/src/tools/move-task.js
@@ -54,6 +54,10 @@ export function registerMoveTaskTool(server) {
.optional()
.describe('Break cross-tag dependencies during move')
}),
+ annotations: {
+ title: 'Move Task',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
// Check if this is a cross-tag move
diff --git a/mcp-server/src/tools/next-task.js b/mcp-server/src/tools/next-task.js
index d41ccaf8..36b65faa 100644
--- a/mcp-server/src/tools/next-task.js
+++ b/mcp-server/src/tools/next-task.js
@@ -38,6 +38,10 @@ export function registerNextTaskTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Next Task',
+ readOnlyHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Finding next task with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/parse-prd.js b/mcp-server/src/tools/parse-prd.js
index 8a54ef43..553e945f 100644
--- a/mcp-server/src/tools/parse-prd.js
+++ b/mcp-server/src/tools/parse-prd.js
@@ -65,6 +65,10 @@ export function registerParsePRDTool(server) {
.optional()
.describe('Append generated tasks to existing file.')
}),
+ annotations: {
+ title: 'Parse PRD',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(
async (args, { log, session, reportProgress }) => {
try {
diff --git a/mcp-server/src/tools/remove-dependency.js b/mcp-server/src/tools/remove-dependency.js
index 2ca8d5d2..cb641172 100644
--- a/mcp-server/src/tools/remove-dependency.js
+++ b/mcp-server/src/tools/remove-dependency.js
@@ -31,6 +31,10 @@ export function registerRemoveDependencyTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Remove Dependency',
+ destructiveHint: true
+ },
execute: withToolContext('remove-dependency', async (args, context) => {
try {
const resolvedTag = resolveTag({
diff --git a/mcp-server/src/tools/remove-subtask.js b/mcp-server/src/tools/remove-subtask.js
index e3a4db19..7e8b1fc9 100644
--- a/mcp-server/src/tools/remove-subtask.js
+++ b/mcp-server/src/tools/remove-subtask.js
@@ -48,6 +48,10 @@ export function registerRemoveSubtaskTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Remove Subtask',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
const resolvedTag = resolveTag({
diff --git a/mcp-server/src/tools/remove-task.js b/mcp-server/src/tools/remove-task.js
index d6666548..5621a784 100644
--- a/mcp-server/src/tools/remove-task.js
+++ b/mcp-server/src/tools/remove-task.js
@@ -42,6 +42,10 @@ export function registerRemoveTaskTool(server) {
'Specify which tag context to operate on. Defaults to the current active tag.'
)
}),
+ annotations: {
+ title: 'Remove Task',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Removing task(s) with ID(s): ${args.id}`);
diff --git a/mcp-server/src/tools/rename-tag.js b/mcp-server/src/tools/rename-tag.js
index 6d5dc1de..398b8985 100644
--- a/mcp-server/src/tools/rename-tag.js
+++ b/mcp-server/src/tools/rename-tag.js
@@ -31,6 +31,10 @@ export function registerRenameTagTool(server) {
.string()
.describe('The directory of the project. Must be an absolute path.')
}),
+ annotations: {
+ title: 'Rename Tag',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Starting rename-tag with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/research.js b/mcp-server/src/tools/research.js
index 54c4ebc2..f743ea8f 100644
--- a/mcp-server/src/tools/research.js
+++ b/mcp-server/src/tools/research.js
@@ -66,6 +66,11 @@ export function registerResearchTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Research',
+ destructiveHint: true,
+ openWorldHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
const resolvedTag = resolveTag({
diff --git a/mcp-server/src/tools/response-language.js b/mcp-server/src/tools/response-language.js
index 7f602aa5..52ccd3c6 100644
--- a/mcp-server/src/tools/response-language.js
+++ b/mcp-server/src/tools/response-language.js
@@ -22,6 +22,10 @@ export function registerResponseLanguageTool(server) {
'The new response language to set. like "中文" "English" or "español".'
)
}),
+ annotations: {
+ title: 'Response Language',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(
diff --git a/mcp-server/src/tools/rules.js b/mcp-server/src/tools/rules.js
index 527bac8e..7684cf92 100644
--- a/mcp-server/src/tools/rules.js
+++ b/mcp-server/src/tools/rules.js
@@ -43,6 +43,10 @@ export function registerRulesTool(server) {
'DANGEROUS: Force removal even if it would leave no rule profiles. Only use if you are absolutely certain.'
)
}),
+ annotations: {
+ title: 'Rules',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(
diff --git a/mcp-server/src/tools/scope-down.js b/mcp-server/src/tools/scope-down.js
index d7ea82cb..9433209b 100644
--- a/mcp-server/src/tools/scope-down.js
+++ b/mcp-server/src/tools/scope-down.js
@@ -50,6 +50,10 @@ export function registerScopeDownTool(server) {
.optional()
.describe('Whether to use research capabilities for scoping')
}),
+ annotations: {
+ title: 'Scope Down Task',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Starting scope-down with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/scope-up.js b/mcp-server/src/tools/scope-up.js
index e7c01f61..9be10cb2 100644
--- a/mcp-server/src/tools/scope-up.js
+++ b/mcp-server/src/tools/scope-up.js
@@ -50,6 +50,10 @@ export function registerScopeUpTool(server) {
.optional()
.describe('Whether to use research capabilities for scoping')
}),
+ annotations: {
+ title: 'Scope Up Task',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Starting scope-up with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/set-task-status.js b/mcp-server/src/tools/set-task-status.js
index 385be290..0bed7a40 100644
--- a/mcp-server/src/tools/set-task-status.js
+++ b/mcp-server/src/tools/set-task-status.js
@@ -51,6 +51,10 @@ export function registerSetTaskStatusTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Optional tag context to operate on')
}),
+ annotations: {
+ title: 'Set Task Status',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(
diff --git a/mcp-server/src/tools/update-subtask.js b/mcp-server/src/tools/update-subtask.js
index 7a0c67b3..54366367 100644
--- a/mcp-server/src/tools/update-subtask.js
+++ b/mcp-server/src/tools/update-subtask.js
@@ -38,6 +38,10 @@ export function registerUpdateSubtaskTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Update Subtask',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
const toolName = 'update_subtask';
diff --git a/mcp-server/src/tools/update-task.js b/mcp-server/src/tools/update-task.js
index 6415134d..129d8a9a 100644
--- a/mcp-server/src/tools/update-task.js
+++ b/mcp-server/src/tools/update-task.js
@@ -47,6 +47,10 @@ export function registerUpdateTaskTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Update Task',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
const toolName = 'update_task';
try {
diff --git a/mcp-server/src/tools/update.js b/mcp-server/src/tools/update.js
index af448920..341e4e7c 100644
--- a/mcp-server/src/tools/update.js
+++ b/mcp-server/src/tools/update.js
@@ -47,6 +47,10 @@ export function registerUpdateTool(server) {
),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Update Tasks',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
const toolName = 'update';
const { from, prompt, research, file, projectRoot, tag } = args;
diff --git a/mcp-server/src/tools/use-tag.js b/mcp-server/src/tools/use-tag.js
index 3b08d642..f482c6bd 100644
--- a/mcp-server/src/tools/use-tag.js
+++ b/mcp-server/src/tools/use-tag.js
@@ -30,6 +30,10 @@ export function registerUseTagTool(server) {
.string()
.describe('The directory of the project. Must be an absolute path.')
}),
+ annotations: {
+ title: 'Use Tag',
+ destructiveHint: true
+ },
execute: withNormalizedProjectRoot(async (args, { log, session }) => {
try {
log.info(`Starting use-tag with args: ${JSON.stringify(args)}`);
diff --git a/mcp-server/src/tools/validate-dependencies.js b/mcp-server/src/tools/validate-dependencies.js
index ed088141..7cc1a018 100644
--- a/mcp-server/src/tools/validate-dependencies.js
+++ b/mcp-server/src/tools/validate-dependencies.js
@@ -25,6 +25,10 @@ export function registerValidateDependenciesTool(server) {
.describe('The directory of the project. Must be an absolute path.'),
tag: z.string().optional().describe('Tag context to operate on')
}),
+ annotations: {
+ title: 'Validate Dependencies',
+ readOnlyHint: true
+ },
execute: withToolContext(
'validate-dependencies',
async (args, { log, session }) => {