mcp-adr-analysis-server 2.13.0 → 2.14.0

package/dist/src/tools/mcp-tool-schemas.js

@@ -51,11 +51,17 @@ export function getSearchToolsDefinition() {
     };
 }
 export const MCP_TOOL_SCHEMAS = [
-    // Meta-tool for dynamic tool discovery (CE-MCP Phase 3)
-    getSearchToolsDefinition(),
+    // search_tools removed from wire — spec assigns to host, ADR-023 (#1673)
     {
         name: 'analyze_project_ecosystem',
         description: 'Comprehensive recursive project ecosystem analysis with advanced prompting techniques (Knowledge Generation + Reflexion)',
+        annotations: {
+            title: 'Analyze Project Ecosystem',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -117,6 +123,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_architectural_context',
         description: 'Get detailed architectural context for specific files or the entire project, automatically sets up ADR infrastructure if missing, and provides outcome-focused workflow for project success',
+        annotations: {
+            title: 'Get Architectural Context',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -135,6 +148,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'generate_adrs_from_prd',
         description: 'Generate Architectural Decision Records from a Product Requirements Document with advanced prompting techniques (APE + Knowledge Generation)',
+        annotations: {
+            title: 'Generate ADRs from PRD',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -181,6 +201,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'compare_adr_progress',
         description: 'Compare TODO.md progress against ADRs and current environment to validate implementation status',
+        annotations: {
+            title: 'Compare ADR Progress',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -272,6 +299,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'analyze_content_security',
         description: 'Analyze content for sensitive information using AI-powered detection with optional memory integration for security pattern learning',
+        annotations: {
+            title: 'Analyze Content Security',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -312,6 +346,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'generate_content_masking',
         description: 'Generate masking instructions for detected sensitive content',
+        annotations: {
+            title: 'Generate Content Masking',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -346,6 +387,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'configure_custom_patterns',
         description: 'Configure custom sensitive patterns for a project',
+        annotations: {
+            title: 'Configure Custom Patterns',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -365,6 +413,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'apply_basic_content_masking',
         description: 'Apply basic content masking (fallback when AI is not available)',
+        annotations: {
+            title: 'Apply Basic Content Masking',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -385,6 +440,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'validate_content_masking',
         description: 'Validate that content masking was applied correctly',
+        annotations: {
+            title: 'Validate Content Masking',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -403,6 +465,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'manage_cache',
         description: 'Manage MCP resource cache (clear, stats, cleanup)',
+        annotations: {
+            title: 'Manage Cache',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -422,6 +491,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'configure_output_masking',
         description: 'Configure content masking for all MCP outputs',
+        annotations: {
+            title: 'Configure Output Masking',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -451,6 +527,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'suggest_adrs',
         description: 'Suggest architectural decisions with advanced prompting techniques (Knowledge Generation + Reflexion). TIP: Read @.mcp-server-context.md first for project history, patterns, and previous ADRs to ensure consistency.',
+        annotations: {
+            title: 'Suggest ADRs',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -509,6 +592,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'generate_adr_from_decision',
         description: 'Generate a complete ADR from decision data. TIP: Reference @.mcp-server-context.md to align with existing architectural patterns and decisions.',
+        annotations: {
+            title: 'Generate ADR from Decision',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -555,6 +645,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'generate_adr_bootstrap',
         description: "Generate bootstrap.sh and validate_bootstrap.sh scripts to ensure deployed code follows ADR requirements. **CRITICAL**: Before generating scripts, use WebFetch to query the base code repository (e.g., https://github.com/validatedpatterns/common for OpenShift) and authoritative pattern documentation (e.g., https://play.validatedpatterns.io/). Merge the base repository code into your project and have bootstrap.sh call the pattern's scripts rather than generating everything from scratch. This ensures compliance with validated deployment patterns.",
+        annotations: {
+            title: 'Generate ADR Bootstrap',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -600,6 +697,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'bootstrap_validation_loop',
         description: '**GUIDED EXECUTION MODE**: This tool guides you through an interactive, step-by-step deployment validation workflow. It does NOT execute commands internally - instead, it tells YOU what commands to run and processes the results iteratively. **Workflow**: (1) First call with iteration=0: Detects platform (OpenShift/K8s/Docker), validates environment connection, and requests human approval for target platform. (2) Subsequent calls: After running each command and reporting back with output, the tool provides next steps. **Environment Validation**: Before deployment, the tool verifies connection to the target platform (e.g., `oc status` for OpenShift, `kubectl cluster-info` for K8s) and requires explicit human confirmation. **Validated Patterns Integration**: Automatically identifies base code repositories (e.g., validatedpatterns/common for OpenShift) and guides you to merge them into your project. **Deployment Cleanup**: Supports CI/CD-style workflows with deployment teardown/restart guidance. **Call this tool iteratively**, passing previous command output back each time.',
+        annotations: {
+            title: 'Bootstrap Validation Loop',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -664,6 +768,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'discover_existing_adrs',
         description: 'Discover and catalog existing ADRs in the project',
+        annotations: {
+            title: 'Discover Existing ADRs',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -683,6 +794,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'analyze_adr_timeline',
         description: 'Analyze ADR timeline with smart time tracking, adaptive thresholds, and actionable recommendations. Auto-detects project context (startup/growth/mature) and generates prioritized work queue based on staleness, implementation lag, and technical debt.',
+        annotations: {
+            title: 'Analyze ADR Timeline',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -727,6 +845,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'review_existing_adrs',
         description: 'Review existing ADRs against actual code implementation with cloud/DevOps expertise. TIP: After review, call get_server_context to update @.mcp-server-context.md with findings.',
+        annotations: {
+            title: 'Review Existing ADRs',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -766,6 +891,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'validate_adr',
         description: 'Validate an existing ADR against actual infrastructure reality using research-driven analysis. TIP: Compare findings against patterns in @.mcp-server-context.md for consistency checks.',
+        annotations: {
+            title: 'Validate ADR',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -800,6 +932,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'validate_all_adrs',
         description: 'Validate all ADRs in a directory against actual infrastructure reality',
+        annotations: {
+            title: 'Validate All ADRs',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -829,6 +968,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'incorporate_research',
         description: 'Incorporate research findings into architectural decisions',
+        annotations: {
+            title: 'Incorporate Research',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -900,6 +1046,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'create_research_template',
         description: 'Create a research template file for documenting findings',
+        annotations: {
+            title: 'Create Research Template',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -924,6 +1077,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'request_action_confirmation',
         description: 'Request confirmation before applying research-based changes',
+        annotations: {
+            title: 'Request Action Confirmation',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -948,6 +1108,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'generate_rules',
         description: 'Generate architectural rules from ADRs and code patterns',
+        annotations: {
+            title: 'Generate Rules',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -991,6 +1158,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'validate_rules',
         description: 'Validate code against architectural rules',
+        annotations: {
+            title: 'Validate Rules',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1041,6 +1215,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'create_rule_set',
         description: 'Create machine-readable rule set in JSON/YAML format',
+        annotations: {
+            title: 'Create Rule Set',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1086,6 +1267,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'analyze_environment',
         description: 'Analyze environment context and provide optimization recommendations with optional memory integration for environment snapshot tracking',
+        annotations: {
+            title: 'Analyze Environment',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1134,6 +1322,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'generate_research_questions',
         description: 'Generate context-aware research questions and create research tracking system',
+        annotations: {
+            title: 'Generate Research Questions',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1234,6 +1429,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'perform_research',
         description: 'Perform research using cascading sources: project files → session/tool-usage tracker → environment resources → web search (fallback)',
+        annotations: {
+            title: 'Perform Research',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1275,6 +1477,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'search_codebase',
         description: 'Atomic tool for searching codebase files based on query patterns. Returns raw file matches with relevance scores. Extracted from ResearchOrchestrator per ADR-018.',
+        annotations: {
+            title: 'Search Codebase',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1323,6 +1532,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'analyze_deployment_progress',
         description: 'Analyze deployment progress and verify completion with outcome rules',
+        annotations: {
+            title: 'Analyze Deployment Progress',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1404,18 +1620,17 @@ export const MCP_TOOL_SCHEMAS = [
             },
         },
     },
-    {
-        name: 'check_ai_execution_status',
-        description: 'Check AI execution configuration and status for debugging prompt-only mode issues',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-            required: [],
-        },
-    },
+    // check_ai_execution_status removed — dies with AI layer, ADR-023 (#1673)
     {
         name: 'get_workflow_guidance',
         description: 'Get intelligent workflow guidance and tool recommendations based on your goals and project context to achieve expected outcomes efficiently',
+        annotations: {
+            title: 'Get Workflow Guidance',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1458,6 +1673,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_development_guidance',
         description: 'Get comprehensive development guidance that translates architectural decisions and workflow recommendations into specific coding tasks, implementation patterns, and development roadmap',
+        annotations: {
+            title: 'Get Development Guidance',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1514,81 +1736,18 @@ export const MCP_TOOL_SCHEMAS = [
             required: ['developmentPhase'],
         },
     },
-    {
-        name: 'list_roots',
-        description: '[DEPRECATED host-native, ADR-023] List available file system roots that can be accessed. Use this to discover what directories are available before reading files.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'read_directory',
-        description: '[DEPRECATED host-native, ADR-023] List files and folders in a directory. Use this to explore the file structure within accessible roots.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                path: {
-                    type: 'string',
-                    description: 'Directory path to list (relative to project root or absolute within roots)',
-                },
-            },
-            required: ['path'],
-        },
-    },
-    {
-        name: 'read_file',
-        description: '[DEPRECATED host-native, ADR-023] Read contents of a file',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                filePath: {
-                    type: 'string',
-                    description: 'Path to the file to read',
-                },
-                path: {
-                    type: 'string',
-                    description: 'Path to the file to read (alias for filePath)',
-                },
-            },
-            required: [],
-        },
-    },
-    {
-        name: 'write_file',
-        description: '[DEPRECATED host-native, ADR-023] Write content to a file',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                path: {
-                    type: 'string',
-                    description: 'Path to the file to write',
-                },
-                content: {
-                    type: 'string',
-                    description: 'Content to write to the file',
-                },
-            },
-            required: ['path', 'content'],
-        },
-    },
-    {
-        name: 'list_directory',
-        description: '[DEPRECATED host-native, ADR-023] List contents of a directory',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                path: {
-                    type: 'string',
-                    description: 'Path to the directory to list',
-                },
-            },
-            required: ['path'],
-        },
-    },
+    // Host-native tools removed: list_roots, read_directory, read_file,
+    // write_file, list_directory — ADR-023 Phase 0 (#1673)
     {
         name: 'generate_deployment_guidance',
         description: 'Generate deployment guidance and instructions from ADRs with environment-specific configurations',
+        annotations: {
+            title: 'Generate Deployment Guidance',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1668,6 +1827,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'smart_git_push',
         description: 'AI-driven security-focused git push with credential detection, file filtering, and deployment metrics tracking. Tests should be run by calling AI and results provided.',
+        annotations: {
+            title: 'Smart Git Push',
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1755,6 +1921,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'deployment_readiness',
         description: 'Comprehensive deployment readiness validation with test failure tracking, deployment history analysis, and hard blocking for unsafe deployments. Integrates with smart_git_push for deployment gating.',
+        annotations: {
+            title: 'Check Deployment Readiness',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -1892,6 +2065,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'release_tracking',
         description: 'Track releases mapped to ADR decisions. Generates changelogs, manages milestones, compares releases, and assesses release readiness. Supports greenfield and brownfield projects. Writes CHANGELOG.md, creates GitHub Releases and Milestones.',
+        annotations: {
+            title: 'Track Releases',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2011,6 +2191,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'generate_adr_todo',
         description: 'Generate TODO.md from ADRs with comprehensive task breakdown. Decomposes each ADR into paired test+production tasks (TDD), links tasks to release milestones, and preserves manual edits via a bounded HTML-comment section. Re-runs are idempotent; tasks for deleted/superseded ADRs move to a Stale Tasks section.',
+        annotations: {
+            title: 'Generate ADR Todo',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2057,6 +2244,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'troubleshoot_guided_workflow',
         description: 'Structured failure analysis and test plan generation with memory integration for troubleshooting session tracking and intelligent ADR/research suggestion capabilities - provide JSON failure info to get specific test commands',
+        annotations: {
+            title: 'Troubleshoot Guided Workflow',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2189,6 +2383,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'smart_score',
         description: 'Central coordination for project health scoring system - recalculate, sync, diagnose, optimize, and reset scores across all MCP tools',
+        annotations: {
+            title: 'Smart Score',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2329,6 +2530,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'mcp_planning',
         description: 'Enhanced project planning and workflow management tool - phase-based project management, team resource allocation, progress tracking, risk analysis, and executive reporting',
+        annotations: {
+            title: 'MCP Planning',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2568,6 +2776,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'interactive_adr_planning',
         description: 'Interactive guided ADR planning and creation tool - walks users through structured decision-making process with research integration, option evaluation, and automatic ADR generation. TIP: Start by reading @.mcp-server-context.md to understand project context and previous decisions.',
+        annotations: {
+            title: 'Interactive ADR Planning',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2619,6 +2834,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'memory_loading',
         description: 'Advanced memory loading tool for the memory-centric architecture. Query, explore, and manage memory entities and relationships. Load ADRs into memory system and perform intelligent queries.',
+        annotations: {
+            title: 'Load Memory',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2770,6 +2992,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'expand_analysis_section',
         description: 'Retrieve full analysis content from tiered responses. Expand entire analysis or specific sections stored in memory. Use this when a tool returns a summary with an expandable ID.',
+        annotations: {
+            title: 'Expand Analysis Section',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2794,6 +3023,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'tool_chain_orchestrator',
         description: 'AI-powered dynamic tool sequencing - intelligently analyze user requests and generate structured tool execution plans',
+        annotations: {
+            title: 'Tool Chain Orchestrator',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2834,6 +3070,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'expand_memory',
         description: 'Phase 3: Retrieve and expand stored content from a tiered response using its expandable ID',
+        annotations: {
+            title: 'Expand Memory',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2857,6 +3100,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'query_conversation_history',
         description: 'Phase 3: Search and retrieve conversation sessions based on filters',
+        annotations: {
+            title: 'Query Conversation History',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2892,6 +3142,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_conversation_snapshot',
         description: 'Phase 3: Get current conversation context snapshot for resumption or analysis',
+        annotations: {
+            title: 'Get Conversation Snapshot',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2906,6 +3163,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_memory_stats',
         description: 'Phase 3: Get statistics about stored conversation memory',
+        annotations: {
+            title: 'Get Memory Stats',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {},
@@ -2914,6 +3178,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'update_knowledge',
         description: 'ADR-018: Simple CRUD operations for project session state. Not a graph database — keyword retrieval over local JSON snapshots. Add/remove entities (intents, ADRs, tools, code) and relationships. Use knowledge://graph resource to read current state (zero token cost).',
+        annotations: {
+            title: 'Update Knowledge',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2956,6 +3227,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_server_context',
         description: "Generate a comprehensive context file showing the server's current state, memory, and capabilities. Creates .mcp-server-context.md that can be @ referenced in conversations for instant LLM awareness",
+        annotations: {
+            title: 'Get Server Context',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -2981,35 +3259,18 @@ export const MCP_TOOL_SCHEMAS = [
             },
         },
     },
-    {
-        name: 'get_current_datetime',
-        description: '[DEPRECATED host-native, ADR-023] Get the current date and time in various formats. Useful for timestamping ADRs, research documents, and other architectural artifacts. Returns ISO 8601, human-readable, and ADR-specific date formats.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                timezone: {
-                    type: 'string',
-                    description: 'Timezone for the datetime (e.g., "UTC", "America/New_York", "Europe/London"). Defaults to UTC.',
-                    default: 'UTC',
-                },
-                format: {
-                    type: 'string',
-                    enum: ['iso', 'human', 'adr', 'all'],
-                    description: 'Output format: "iso" for ISO 8601, "human" for human-readable, "adr" for ADR date format (YYYY-MM-DD), "all" for all formats',
-                    default: 'all',
-                },
-                includeTimestamp: {
-                    type: 'boolean',
-                    description: 'Include Unix timestamp in milliseconds',
-                    default: true,
-                },
-            },
-        },
-    },
+    // get_current_datetime removed — host-native, ADR-023 (#1673)
     // Session management tool for dynamic project switching
     {
         name: 'set_project_path',
         description: 'Dynamically set the active project path for the current session. Call this at the start of a session to switch between projects without restarting the server or modifying environment variables. All subsequent tool calls will use this path as the default.',
+        annotations: {
+            title: 'Set Project Path',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3026,45 +3287,18 @@ export const MCP_TOOL_SCHEMAS = [
             required: ['path'],
         },
     },
-    // CE-MCP Phase 4: Lazy Prompt Loading Tool
-    {
-        name: 'load_prompt',
-        description: '[DEPRECATED host-native, ADR-023] Load a specific prompt or prompt section on-demand. Part of CE-MCP lazy loading system that reduces token usage by ~96% by loading prompts only when needed. Use this to retrieve prompt templates for ADR generation, analysis, deployment, and other operations.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                promptName: {
-                    type: 'string',
-                    description: 'Name of the prompt to load (e.g., "adr-suggestion", "deployment-analysis", "environment-analysis", "research-question", "rule-generation", "analysis", "security")',
-                    enum: [
-                        'adr-suggestion',
-                        'deployment-analysis',
-                        'environment-analysis',
-                        'research-question',
-                        'rule-generation',
-                        'analysis',
-                        'research-integration',
-                        'validated-pattern',
-                        'security',
-                    ],
-                },
-                section: {
-                    type: 'string',
-                    description: 'Specific section within the prompt to load. If not provided, loads the entire prompt. Available sections depend on the prompt.',
-                },
-                estimateOnly: {
-                    type: 'boolean',
-                    description: 'If true, returns only token estimate without loading the full prompt content',
-                    default: false,
-                },
-            },
-            required: ['promptName'],
-        },
-    },
+    // load_prompt removed — spec assigns to host, ADR-023 (#1673)
     // ADR Aggregator Integration Tools (https://adraggregator.com)
     {
         name: 'sync_to_aggregator',
         description: 'Sync ADRs to ADR Aggregator platform (https://adraggregator.com) for centralized tracking, visualization, and team collaboration. Supports incremental and full sync modes with optional metadata.',
+        annotations: {
+            title: 'Sync to Aggregator',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3113,6 +3347,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_adr_context',
         description: 'Fetch ADR context from ADR Aggregator including summaries, diagrams, timeline data, and code links. Useful for getting a consolidated view of architectural decisions.',
+        annotations: {
+            title: 'Get ADR Context',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3158,6 +3399,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_staleness_report',
         description: 'Get ADR staleness report from ADR Aggregator with review compliance metrics. Identifies stale ADRs that need attention and provides governance insights.',
+        annotations: {
+            title: 'Get Staleness Report',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3176,6 +3424,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_adr_templates',
         description: 'Get domain-specific ADR templates and anti-patterns from ADR Aggregator. Includes best practices for web applications, microservices, APIs, and more. No authentication required.',
+        annotations: {
+            title: 'Get ADR Templates',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3189,6 +3444,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_adr_diagrams',
         description: 'Get Mermaid diagrams for ADRs from ADR Aggregator. Includes workflow, relationship, and impact diagrams. Requires Pro+ tier.',
+        annotations: {
+            title: 'Get ADR Diagrams',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3206,6 +3468,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'validate_adr_compliance',
         description: 'Validate ADR compliance against implementation via ADR Aggregator. Checks that code actually implements documented decisions. Requires Pro+ tier.',
+        annotations: {
+            title: 'Validate ADR Compliance',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3230,6 +3499,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_knowledge_graph',
         description: 'Get cross-repository knowledge graph from ADR Aggregator with analytics and insights. Visualize ADR relationships across repositories. Requires Team tier.',
+        annotations: {
+            title: 'Get Knowledge Graph',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3254,6 +3530,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'update_implementation_status',
         description: 'Update the implementation status of synced ADRs directly from the IDE. Supports statuses: not_started, in_progress, implemented, deprecated, blocked. Requires Pro+ tier.',
+        annotations: {
+            title: 'Update Implementation Status',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3291,6 +3574,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_adr_priorities',
         description: 'Get ADR priorities for roadmap and backlog planning from ADR Aggregator. Returns prioritized ADRs with scores, dependencies, blockers, implementation status, and gap counts.',
+        annotations: {
+            title: 'Get ADR Priorities',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3309,6 +3599,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'analyze_gaps',
         description: 'Scan local codebase and compare with ADRs to detect bi-directional gaps. Finds: (1) ADR-to-code gaps: file references in ADRs that do not exist, (2) Code-to-ADR gaps: technologies in package.json and architectural patterns without ADR coverage. Reports gaps to ADR Aggregator for tracking.',
+        annotations: {
+            title: 'Analyze Gaps',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {
@@ -3347,6 +3644,13 @@ export const MCP_TOOL_SCHEMAS = [
     {
         name: 'get_gaps',
         description: 'Get current code gaps from ADR Aggregator. Returns gaps with their status (open, dismissed, resolved) for tracking and management.',
+        annotations: {
+            title: 'Get Gaps',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             type: 'object',
             properties: {