tascan-mcp 2.4.0 → 3.0.0

package/index.js

@@ -1,14 +1,20 @@
 #!/usr/bin/env node
 
 // ============================================================
-// TaScan MCP Server
-// Wraps TaScan REST API v1 for Claude and other AI agents
-// Transport: stdio (for Claude Desktop / Claude Code)
+// TaScan MCP Server — stdio transport
+// Thin transport over the canonical tool registry (tools.cjs),
+// which is shared with the remote HTTP endpoint at
+// https://app.tascan.io/mcp. Add or change tools in tools.cjs —
+// never here.
 // ============================================================
 
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url);
+const { TOOLS } = require('./tools.cjs');
 
 const API_BASE = process.env.TASCAN_API_URL || 'https://app.tascan.io/api/v1';
 const API_KEY = process.env.TASCAN_API_KEY || '';
@@ -18,9 +24,8 @@ if (!API_KEY) {
   process.exit(1);
 }
 
-// ─── API Helper ────────────────────────────────────────────
-async function apiCall(method, path, body) {
-  const url = API_BASE + path;
+// Transport-bound REST call handed to every tool handler
+async function api(method, path, body) {
   const opts = {
     method,
     headers: {
@@ -28,927 +33,41 @@ async function apiCall(method, path, body) {
       'Content-Type': 'application/json'
     }
   };
-
   if (body && (method === 'POST' || method === 'PUT')) {
     opts.body = JSON.stringify(body);
   }
-
-  const resp = await fetch(url, opts);
+  const resp = await fetch(API_BASE + path, opts);
   const data = await resp.json();
-
   if (!resp.ok) {
     throw new Error(data.error || `API error ${resp.status}`);
   }
-
   return data;
 }
 
-// ─── Server Setup ──────────────────────────────────────────
-const server = new McpServer({
-  name: 'tascan',
-  version: '2.4.0'
-});
-
-
-// ─── Tool: List Projects ───────────────────────────────────
-server.registerTool(
-  'tascan_list_projects',
-  {
-    title: 'List Projects',
-    description: 'List all TaScan projects in the organization',
-    inputSchema: {},
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false
-    }
-  },
-  async () => {
-    const result = await apiCall('GET', '/projects');
-    return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(result.data, null, 2)
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Create Project ──────────────────────────────────
-server.registerTool(
-  'tascan_create_project',
-  {
-    title: 'Create Project',
-    description: 'Create a new TaScan project (top-level container for events)',
-    inputSchema: {
-      name: z.string().describe('Project name'),
-      location: z.string().optional().describe('Project location / venue')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ name, location }) => {
-    const result = await apiCall('POST', '/projects', { name, location });
-    return {
-      content: [{
-        type: 'text',
-        text: `Project created: ${result.data.name} (ID: ${result.data.id})\n\n${JSON.stringify(result.data, null, 2)}`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Create Event (Task List) ────────────────────────
-server.registerTool(
-  'tascan_create_event',
-  {
-    title: 'Create Event',
-    description: 'Create a new event (task list) within a project',
-    inputSchema: {
-      project_id: z.string().describe('Project ID to add the event to'),
-      name: z.string().describe('Event name'),
-      description: z.string().optional().describe('Event description')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ project_id, name, description }) => {
-    const result = await apiCall('POST', `/projects/${project_id}/lists`, { name, description });
-    return {
-      content: [{
-        type: 'text',
-        text: `Event created: ${result.data.name} (ID: ${result.data.id})\n\n${JSON.stringify(result.data, null, 2)}`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Add Tasks (Bulk) ────────────────────────────────
-server.registerTool(
-  'tascan_add_tasks',
-  {
-    title: 'Add Tasks',
-    description: 'Add one or more tasks to an event (task list). Supports bulk creation. IMPORTANT: Set response_type correctly — use "text" for info collection (names, phones, emails, notes), "photo" for visual verification (inspections, serial numbers, damage checks), "checkbox" only for simple confirmations.',
-    inputSchema: {
-      list_id: z.string().describe('Task list (event) ID'),
-      tasks: z.array(z.object({
-        title: z.string().describe('Task title'),
-        description: z.string().optional().describe('Task description'),
-        response_type: z.enum(['checkbox', 'photo', 'text', 'number', 'date', 'choice']).optional().describe('CRITICAL: "text" for names, phones, emails, notes, any free-form input. "photo" for visual proof (inspections, serial numbers, packed cases). "checkbox" ONLY for yes/no confirmations. "number" for numeric values. "date" for dates. "choice" for multiple-choice (needs response_config.options). Default is checkbox but most info-collection tasks should be "text".'),
-        is_safety_checkpoint: z.boolean().optional().describe('Safety-critical task flag'),
-        requires_photo: z.boolean().optional().describe('Require photo on completion')
-      })).describe('Array of tasks to create')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ list_id, tasks }) => {
-    const result = await apiCall('POST', `/lists/${list_id}/tasks`, tasks);
-    return {
-      content: [{
-        type: 'text',
-        text: `${result.count} task(s) created in list ${list_id}\n\n${JSON.stringify(result.data, null, 2)}`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: List Workers ────────────────────────────────────
-server.registerTool(
-  'tascan_list_workers',
-  {
-    title: 'List Workers',
-    description: 'List all workers (taskees) in the organization',
-    inputSchema: {},
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false
-    }
-  },
-  async () => {
-    const result = await apiCall('GET', '/workers');
-    return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(result.data, null, 2)
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Create Worker ───────────────────────────────────
-server.registerTool(
-  'tascan_create_worker',
-  {
-    title: 'Create Worker',
-    description: 'Create a new worker (taskee) in the organization',
-    inputSchema: {
-      name: z.string().describe('Worker name'),
-      phone: z.string().optional().describe('Worker phone number'),
-      email: z.string().optional().describe('Worker email')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ name, phone, email }) => {
-    const result = await apiCall('POST', '/workers', { name, phone, email });
-    return {
-      content: [{
-        type: 'text',
-        text: `Worker created: ${result.data.name} (ID: ${result.data.id})\n\n${JSON.stringify(result.data, null, 2)}`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Generate QR Code ────────────────────────────────
-server.registerTool(
-  'tascan_generate_qr',
-  {
-    title: 'Generate QR Code',
-    description: 'Generate a QR code for a task list (event) that workers can scan to access tasks',
-    inputSchema: {
-      list_id: z.string().describe('Task list (event) ID')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ list_id }) => {
-    const result = await apiCall('POST', `/lists/${list_id}/qr`);
-    return {
-      content: [{
-        type: 'text',
-        text: `QR Code generated for "${result.data.list_name}":\n- Scan URL: ${result.data.scan_url}\n- QR Image: ${result.data.qr_image_url}`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Apply Template ──────────────────────────────────
-server.registerTool(
-  'tascan_apply_template',
-  {
-    title: 'Apply Template',
-    description: 'Apply a pre-built template to a task list, adding all template tasks',
-    inputSchema: {
-      list_id: z.string().describe('Task list (event) ID to apply template to'),
-      template_slug: z.string().describe('Template slug (e.g. "conference-load-in", "warehouse-receiving", "restaurant-opening", "hotel-room-turnover")')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ list_id, template_slug }) => {
-    const result = await apiCall('POST', `/lists/${list_id}/apply-template`, { template_slug });
-    return {
-      content: [{
-        type: 'text',
-        text: `Template applied! ${result.count} tasks added to list ${list_id}\n\n${JSON.stringify(result.data, null, 2)}`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Get Report ──────────────────────────────────────
-server.registerTool(
-  'tascan_get_report',
-  {
-    title: 'Get Completion Report',
-    description: 'Get completion report for a task list (event) including task status, completions, workers, and photos',
-    inputSchema: {
-      list_id: z.string().describe('Task list (event) ID')
-    },
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false
-    }
-  },
-  async ({ list_id }) => {
-    const result = await apiCall('GET', `/lists/${list_id}/report`);
-    const r = result.data;
-    let text = `Report for "${r.list_name}":\n`;
-    text += `Completion: ${r.completed_tasks}/${r.total_tasks} (${r.completion_rate}%)\n\n`;
-
-    for (const task of r.tasks) {
-      const status = task.completed ? '[x]' : '[ ]';
-      text += `${status} ${task.title}`;
-      if (task.completions && task.completions.length > 0) {
-        text += ` (by ${task.completions.map(c => c.worker_name).join(', ')})`;
-      }
-      text += '\n';
-    }
-
-    return { content: [{ type: 'text', text }] };
-  }
-);
-
-
-// ─── Tool: List Templates ──────────────────────────────────
-server.registerTool(
-  'tascan_list_templates',
-  {
-    title: 'List Templates',
-    description: 'List available task templates (built-in and saved)',
-    inputSchema: {
-      category: z.string().optional().describe('Filter by category (e.g. "live-events", "hospitality", "logistics", "construction", "facilities", "general", "field-service", "education")')
-    },
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false
-    }
-  },
-  async ({ category }) => {
-    const path = category ? `/templates?category=${encodeURIComponent(category)}` : '/templates';
-    const result = await apiCall('GET', path);
-    return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(result.data, null, 2)
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: List Events (Task Lists) ──────────────────────
-server.registerTool(
-  'tascan_list_events',
-  {
-    title: 'List Events',
-    description: 'List all events (task lists) within a project',
-    inputSchema: {
-      project_id: z.string().describe('Project ID')
-    },
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false
-    }
-  },
-  async ({ project_id }) => {
-    const result = await apiCall('GET', `/projects/${project_id}/lists`);
-    return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(result.data, null, 2)
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Get Event ─────────────────────────────────────
-server.registerTool(
-  'tascan_get_event',
-  {
-    title: 'Get Event',
-    description: 'Get details of a specific event (task list) including its tasks',
-    inputSchema: {
-      list_id: z.string().describe('Task list (event) ID')
-    },
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false
-    }
-  },
-  async ({ list_id }) => {
-    const result = await apiCall('GET', `/lists/${list_id}`);
-    return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(result.data, null, 2)
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: List Tasks ────────────────────────────────────
-server.registerTool(
-  'tascan_list_tasks',
-  {
-    title: 'List Tasks',
-    description: 'List all tasks in an event (task list)',
-    inputSchema: {
-      list_id: z.string().describe('Task list (event) ID')
-    },
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false
-    }
-  },
-  async ({ list_id }) => {
-    const result = await apiCall('GET', `/lists/${list_id}/tasks`);
-    return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(result.data, null, 2)
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Get Project ───────────────────────────────────
-server.registerTool(
-  'tascan_get_project',
-  {
-    title: 'Get Project',
-    description: 'Get details of a specific project',
-    inputSchema: {
-      project_id: z.string().describe('Project ID')
-    },
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false
-    }
-  },
-  async ({ project_id }) => {
-    const result = await apiCall('GET', `/projects/${project_id}`);
-    return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(result.data, null, 2)
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Get Task ──────────────────────────────────────
-server.registerTool(
-  'tascan_get_task',
-  {
-    title: 'Get Task',
-    description: 'Get details of a specific task including completions',
-    inputSchema: {
-      task_id: z.string().describe('Task ID')
-    },
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false
-    }
-  },
-  async ({ task_id }) => {
-    const result = await apiCall('GET', `/tasks/${task_id}`);
-    return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(result.data, null, 2)
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Update Project ────────────────────────────────
-server.registerTool(
-  'tascan_update_project',
-  {
-    title: 'Update Project',
-    description: 'Update a project (name, location, status, dates)',
-    inputSchema: {
-      project_id: z.string().describe('Project ID'),
-      name: z.string().optional().describe('New project name'),
-      location: z.string().optional().describe('New location'),
-      status: z.enum(['active', 'archived']).optional().describe('Project status'),
-      start_date: z.string().optional().describe('Start date (ISO format)'),
-      end_date: z.string().optional().describe('End date (ISO format)')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ project_id, ...updates }) => {
-    const body = Object.fromEntries(Object.entries(updates).filter(([, v]) => v !== undefined));
-    const result = await apiCall('PUT', `/projects/${project_id}`, body);
-    return {
-      content: [{
-        type: 'text',
-        text: `Project updated: ${result.data.name}\n\n${JSON.stringify(result.data, null, 2)}`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Update Event ──────────────────────────────────
-server.registerTool(
-  'tascan_update_event',
-  {
-    title: 'Update Event',
-    description: 'Update an event / task list (name, description, team_mode, timer_mode)',
-    inputSchema: {
-      list_id: z.string().describe('Task list (event) ID'),
-      name: z.string().optional().describe('New event name'),
-      description: z.string().optional().describe('New description'),
-      team_mode: z.boolean().optional().describe('Team mode on/off'),
-      timer_mode: z.boolean().optional().describe('Timer mode on/off')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ list_id, ...updates }) => {
-    const body = Object.fromEntries(Object.entries(updates).filter(([, v]) => v !== undefined));
-    const result = await apiCall('PUT', `/lists/${list_id}`, body);
-    return {
-      content: [{
-        type: 'text',
-        text: `Event updated: ${result.data.name}\n\n${JSON.stringify(result.data, null, 2)}`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Update Task ───────────────────────────────────
-server.registerTool(
-  'tascan_update_task',
-  {
-    title: 'Update Task',
-    description: 'Update a task (title, description, response_type, flags, sort_order)',
-    inputSchema: {
-      task_id: z.string().describe('Task ID'),
-      title: z.string().optional().describe('New title'),
-      description: z.string().optional().describe('New description'),
-      response_type: z.enum(['checkbox', 'photo', 'text', 'number', 'date', 'choice']).optional().describe('See tascan_add_tasks for guidance. "text" for info collection, "photo" for visual proof, "checkbox" for yes/no only.'),
-      is_safety_checkpoint: z.boolean().optional().describe('Safety-critical flag'),
-      requires_photo: z.boolean().optional().describe('Require photo'),
-      sort_order: z.number().optional().describe('Sort order position')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ task_id, ...updates }) => {
-    const body = Object.fromEntries(Object.entries(updates).filter(([, v]) => v !== undefined));
-    const result = await apiCall('PUT', `/tasks/${task_id}`, body);
-    return {
-      content: [{
-        type: 'text',
-        text: `Task updated: ${result.data.title}\n\n${JSON.stringify(result.data, null, 2)}`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Delete Project ────────────────────────────────
-server.registerTool(
-  'tascan_delete_project',
-  {
-    title: 'Delete Project',
-    description: 'Delete a project and all its events, tasks, and completions',
-    inputSchema: {
-      project_id: z.string().describe('Project ID to delete')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: true
-    }
-  },
-  async ({ project_id }) => {
-    await apiCall('DELETE', `/projects/${project_id}`);
-    return {
-      content: [{
-        type: 'text',
-        text: `Project ${project_id} deleted successfully.`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Delete Event ──────────────────────────────────
-server.registerTool(
-  'tascan_delete_event',
-  {
-    title: 'Delete Event',
-    description: 'Delete an event (task list) and all its tasks and completions',
-    inputSchema: {
-      list_id: z.string().describe('Task list (event) ID to delete')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: true
-    }
-  },
-  async ({ list_id }) => {
-    await apiCall('DELETE', `/lists/${list_id}`);
-    return {
-      content: [{
-        type: 'text',
-        text: `Event ${list_id} deleted successfully.`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Delete Task ───────────────────────────────────
-server.registerTool(
-  'tascan_delete_task',
-  {
-    title: 'Delete Task',
-    description: 'Delete a specific task and its completions',
-    inputSchema: {
-      task_id: z.string().describe('Task ID to delete')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: true
-    }
-  },
-  async ({ task_id }) => {
-    await apiCall('DELETE', `/tasks/${task_id}`);
-    return {
-      content: [{
-        type: 'text',
-        text: `Task ${task_id} deleted successfully.`
-      }]
-    };
-  }
-);
-
-
-// ─── Tool: Update Worker ─────────────────────────────────
-server.registerTool(
-  'tascan_update_worker',
-  {
-    title: 'Update Worker',
-    description: 'Update a worker profile (name, phone, email)',
-    inputSchema: {
-      worker_id: z.string().describe('Worker ID'),
-      name: z.string().optional().describe('New name'),
-      phone: z.string().optional().describe('New phone number'),
-      email: z.string().optional().describe('New email')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ worker_id, ...updates }) => {
-    const body = Object.fromEntries(Object.entries(updates).filter(([, v]) => v !== undefined));
-    const result = await apiCall('PUT', `/workers/${worker_id}`, body);
-    return {
-      content: [{
-        type: 'text',
-        text: `Worker updated: ${result.data.name}\n\n${JSON.stringify(result.data, null, 2)}`
-      }]
-    };
-  }
-);
-
-
-// ─── Closed-Loop Autonomous Operations Protocol ───────────
-
-// Tool 23: List Issues (discover issues for analysis)
-server.registerTool(
-  'tascan_list_issues',
-  {
-    title: 'List Issues',
-    description: 'List all issues for a task list (event). Returns open, acknowledged, and resolved issues. Use to discover issues for AI analysis via tascan_analyze_issue.',
-    inputSchema: {
-      list_id: z.string().describe('Task list (event) ID')
-    },
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false
-    }
-  },
-  async ({ list_id }) => {
-    const result = await apiCall('GET', `/lists/${list_id}/issues`);
-    const issues = result.data;
-    if (!issues.length) return { content: [{ type: 'text', text: 'No issues reported for this task list.' }] };
-    let text = `${issues.length} issue(s) found:\n\n`;
-    issues.forEach((iss, i) => {
-      text += `${i+1}. [${iss.status.toUpperCase()}] ${iss.title}\n`;
-      text += `   ID: ${iss.id} | Type: ${iss.type} | Category: ${iss.category} | Severity: ${iss.severity || 'unset'}\n`;
-      if (iss.tasks) text += `   Task: ${iss.tasks.title}\n`;
-      text += `   Reported: ${iss.created_at}\n\n`;
-    });
-    return { content: [{ type: 'text', text }] };
-  }
+const server = new Server(
+  { name: 'tascan', version: '3.0.0' },
+  { capabilities: { tools: {} } }
 );
 
-// Tool 24: Analyze Issue (Step 1 of Closed-Loop — read issue with full context + optional server AI)
-server.registerTool(
-  'tascan_analyze_issue',
-  {
-    title: 'Analyze Issue',
-    description: 'Step 1 of the Closed-Loop Autonomous Operations Protocol. Returns full issue context including worker info, message thread, project history, and recent similar issues for AI reasoning. Supports optional server-side AI analysis via Anthropic API.',
-    inputSchema: {
-      issue_id: z.string().describe('Issue ID to analyze'),
-      server_side_ai: z.boolean().optional().describe('If true, server calls Anthropic API for analysis (default: false)')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ issue_id, server_side_ai }) => {
-    if (server_side_ai) {
-      const result = await apiCall('POST', `/issues/${issue_id}/analyze`);
-      const d = result.data;
-      let text = `=== AI ANALYSIS (Server-Side) ===\n`;
-      text += `Issue: ${d.issue_title} (${d.issue_id})\nAnalyzed: ${d.analyzed_at}\n\n`;
-      text += JSON.stringify(d.analysis, null, 2);
-      return { content: [{ type: 'text', text }] };
-    }
-
-    const result = await apiCall('GET', `/issues/${issue_id}`);
-    const d = result.data;
-    let text = `=== ISSUE CONTEXT FOR ANALYSIS ===\n`;
-    text += `Issue: ${d.title}\n`;
-    text += `Type: ${d.type} | Category: ${d.category} | Severity: ${d.severity || 'unset'} | Status: ${d.status}\n`;
-    text += `Description: ${d.description || 'none'}\n`;
-    if (d.tasks) text += `Task: ${d.tasks.title} (${d.tasks.response_type || 'checkbox'})\nTask Description: ${d.tasks.description || 'none'}\n`;
-    if (d.worker) text += `Worker: ${d.worker.name} (ID: ${d.worker.id})\n`;
-    if (d.project) text += `Project: ${d.project.name} | Location: ${d.project.location || 'unknown'}\n`;
-    if (d.injury_data) text += `Injury Data: ${JSON.stringify(d.injury_data)}\n`;
-    text += `Reported: ${d.created_at}\n`;
-    if (d.ai_analysis) text += `\n--- PREVIOUS AI ANALYSIS ---\n${JSON.stringify(d.ai_analysis, null, 2)}\n`;
-    if (d.messages && d.messages.length) {
-      text += `\n--- Message Thread (${d.messages.length}) ---\n`;
-      d.messages.forEach(m => { text += `[${m.sender_type}/${m.sender_name}] ${m.message}\n`; });
-    }
-    if (d.recent_issues && d.recent_issues.length) {
-      text += `\n--- Recent Issues on Same Project (${d.recent_issues.length}) ---\n`;
-      d.recent_issues.forEach(ri => { text += `- [${ri.severity}/${ri.category}] ${(ri.description || '').substring(0, 80)} (${ri.status})\n`; });
-    }
-    return { content: [{ type: 'text', text }] };
-  }
-);
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: TOOLS.map(({ name, description, inputSchema, annotations }) => ({
+    name, description, inputSchema, annotations
+  }))
+}));
 
-// Tool 25: Recommend Fix (Step 2 — post recommendation + optional structured tasks)
-server.registerTool(
-  'tascan_recommend_fix',
-  {
-    title: 'Recommend Fix',
-    description: 'Step 2 of the Closed-Loop. Post AI recommendation to issue thread. Accepts optional structured_recommendation with task definitions for auto-dispatch. Persisted in AI audit trail.',
-    inputSchema: {
-      issue_id: z.string().describe('Issue ID to recommend a fix for'),
-      recommendation: z.string().describe('AI recommendation text (clear, actionable instructions)'),
-      structured_recommendation: z.any().optional().describe('Structured recommendation object with tasks for dispatch'),
-      ai_agent: z.string().optional().describe('AI agent name (default: TaScan AI)')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ issue_id, recommendation, structured_recommendation, ai_agent }) => {
-    const body = { recommendation };
-    if (structured_recommendation) body.structured_recommendation = structured_recommendation;
-    if (ai_agent) body.ai_agent = ai_agent;
-    const result = await apiCall('POST', `/issues/${issue_id}/recommend`, body);
-    const d = result.data;
-    let text = `Recommendation posted to issue "${d.issue_title}":\n`;
-    text += `Project: ${d.project_name} | List: ${d.list_name}\n`;
-    text += `Message ID: ${d.message_id}\n\nRecommendation:\n${d.recommendation}`;
-    if (d.structured_recommendation?.tasks) {
-      text += `\n\nStructured Tasks (${d.structured_recommendation.tasks.length}):`;
-      d.structured_recommendation.tasks.forEach((t, i) => { text += `\n  ${i+1}. ${t.title}`; });
-    }
-    return { content: [{ type: 'text', text }] };
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+  const tool = TOOLS.find(t => t.name === req.params.name);
+  if (!tool) {
+    return { content: [{ type: 'text', text: `Unknown tool: ${req.params.name}` }], isError: true };
   }
-);
-
-// Tool 26: Dispatch Instruction (Step 3 — multi-channel delivery + task list creation)
-server.registerTool(
-  'tascan_dispatch_instruction',
-  {
-    title: 'Dispatch Instruction',
-    description: 'Step 3 of the Closed-Loop. Multi-channel dispatch: issue thread, in-app message, progress feed, SMS, and optional remediation task list. Closes the loop from AI analysis to physical worker execution.',
-    inputSchema: {
-      issue_id: z.string().describe('Issue ID'),
-      instruction: z.string().describe('Actionable instruction for the worker'),
-      worker_id: z.string().optional().describe('Target worker ID (defaults to issue reporter)'),
-      remediation_tasks: z.array(z.any()).optional().describe('Tasks to create as remediation task list'),
-      recommendation_summary: z.string().optional().describe('Summary for task list description'),
-      send_sms: z.boolean().optional().describe('Send SMS (default: true if phone on file)'),
-      ai_agent: z.string().optional().describe('AI agent name (default: TaScan AI)')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false
-    }
-  },
-  async ({ issue_id, instruction, worker_id, remediation_tasks, recommendation_summary, send_sms, ai_agent }) => {
-    const body = { instruction };
-    if (worker_id) body.worker_id = worker_id;
-    if (remediation_tasks) body.remediation_tasks = remediation_tasks;
-    if (recommendation_summary) body.recommendation_summary = recommendation_summary;
-    if (send_sms !== undefined) body.send_sms = send_sms;
-    if (ai_agent) body.ai_agent = ai_agent;
-    const result = await apiCall('POST', `/issues/${issue_id}/dispatch`, body);
-    const d = result.data;
-    let text = `Dispatched via ${d.channels.length} channels: ${d.channels.join(', ')}\n`;
-    text += `Worker: ${d.worker_id} | Issue: ${d.issue_id} (${d.issue_status})\n`;
-    text += `SMS: ${d.sms_status}\n`;
-    if (d.remediation_task_list_id) {
-      text += `Task List: ${d.remediation_task_list_id}\nWorker URL: ${d.worker_url}\nTasks: ${d.tasks_created}\n`;
-    }
-    text += `\nInstruction:\n${d.instruction}`;
-    return { content: [{ type: 'text', text }] };
+  try {
+    const text = await tool.handler(req.params.arguments || {}, api);
+    return { content: [{ type: 'text', text: String(text) }] };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
   }
-);
-
-// Tool 27: Auto-Resolve (Full Closed-Loop in one call — Patent Claim 7)
-server.registerTool(
-  'tascan_auto_resolve',
-  {
-    title: 'Auto-Resolve Issue',
-    description: 'FULL Closed-Loop Autonomous Operations Protocol in one call. Server-side AI analyzes issue, generates remediation tasks, creates task list, dispatches to worker via multi-channel delivery — all without human intervention. Patent Claim 7.',
-    inputSchema: {
-      issue_id: z.string().describe('Issue ID to auto-resolve')
-    },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false,
-      openWorldHint: true
-    }
-  },
-  async ({ issue_id }) => {
-    const result = await apiCall('POST', `/issues/${issue_id}/auto-resolve`);
-    const d = result.data;
-    let text = `=== CLOSED-LOOP AUTONOMOUS OPERATIONS PROTOCOL ===\n`;
-    text += `Issue: ${d.issue_id}\n\n`;
-    text += `--- ANALYSIS ---\n`;
-    text += `Summary: ${d.analysis?.summary || 'N/A'}\n`;
-    text += `Classification: ${d.analysis?.classification?.type || 'N/A'} (${d.analysis?.classification?.severity || 'N/A'})\n`;
-    text += `Urgency: ${d.analysis?.urgency_score || 'N/A'}/10\n`;
-    if (d.analysis?.root_cause_hypotheses?.length) {
-      d.analysis.root_cause_hypotheses.forEach((h, i) => {
-        text += `  ${i+1}. ${h.hypothesis} (${Math.round(h.confidence * 100)}%)\n`;
-      });
-    }
-    text += `\n--- RECOMMENDATION ---\n`;
-    text += `Fix: ${d.recommendation?.recommendation_summary || 'N/A'}\n`;
-    text += `Tasks: ${d.recommendation?.tasks?.length || 0}\n`;
-    text += `Duration: ${d.recommendation?.estimated_duration_minutes || 'N/A'} min\n`;
-    text += `\n--- DISPATCH ---\n`;
-    text += `Channels: ${d.dispatch?.channels?.join(', ') || 'none'}\n`;
-    text += `SMS: ${d.dispatch?.sms_status || 'N/A'}\n`;
-    if (d.dispatch?.worker_url) text += `Worker URL: ${d.dispatch.worker_url}\n`;
-    if (d.dispatch?.remediation_task_list_id) text += `Task List: ${d.dispatch.remediation_task_list_id}\n`;
-    text += `\nTimestamps: analyzed ${d.timestamps?.analyzed_at} | recommended ${d.timestamps?.recommended_at} | dispatched ${d.timestamps?.dispatched_at}`;
-    return { content: [{ type: 'text', text }] };
-  }
-);
-
-
-// ─── NFC Tag Registry ─────────────────────────────────────
-
-// Tool 28: Register NFC Tag
-server.registerTool(
-  'tascan_register_tag',
-  {
-    title: 'Register NFC Tag',
-    description: 'Register a physical NFC tag to a project, task list, or specific task. When someone taps the tag, TaScan routes them to the linked resource. Tags use NTAG215 chips and are programmed with NFC Tools Pro.',
-    inputSchema: {
-      tag_hardware_id: z.string().describe('NFC tag hardware serial number (e.g., "04:CB:6C:51:CE:2A:81")'),
-      tag_name: z.string().describe('Friendly name (e.g., "Ballroom A Door", "Breaker Panel 3")'),
-      target_type: z.enum(['project', 'task_list', 'task']).describe('What this tag points to'),
-      project_id: z.string().optional().describe('Project ID'),
-      task_list_id: z.string().optional().describe('Task list ID (required for task_list/task targets)'),
-      task_id: z.string().optional().describe('Task ID (required for task targets)'),
-      location_description: z.string().optional().describe('Physical location of the tag')
-    },
-    annotations: { readOnlyHint: false, destructiveHint: false }
-  },
-  async ({ tag_hardware_id, tag_name, target_type, project_id, task_list_id, task_id, location_description }) => {
-    const result = await apiCall('POST', '/tags', {
-      tag_hardware_id, tag_name, target_type, project_id, task_list_id, task_id, location_description
-    });
-    const d = result.data;
-    const nfcUrl = 'https://app.tascan.io/scan?tag={TAG-ID}&time={DATETIME}';
-    return {
-      content: [{
-        type: 'text',
-        text: `Tag registered: "${d.tag_name}" (${d.tag_hardware_id})\nTarget: ${d.target_type}\nID: ${d.id}\n\nProgram the NFC tag with this URL:\n${nfcUrl}\n\n${JSON.stringify(d, null, 2)}`
-      }]
-    };
-  }
-);
-
-// Tool 29: List Tags
-server.registerTool(
-  'tascan_list_tags',
-  {
-    title: 'List NFC Tags',
-    description: 'List all registered NFC tags in the organization with their linked projects/task lists and scan counts',
-    inputSchema: {},
-    annotations: { readOnlyHint: true, destructiveHint: false }
-  },
-  async () => {
-    const result = await apiCall('GET', '/tags');
-    const tags = result.data;
-    if (!tags.length) return { content: [{ type: 'text', text: 'No NFC tags registered.' }] };
-    let text = `${tags.length} tag(s) registered:\n\n`;
-    tags.forEach((t, i) => {
-      text += `${i+1}. "${t.tag_name}" — ${t.tag_hardware_id}\n`;
-      text += `   Target: ${t.target_type} | Scans: ${t.scan_count} | Active: ${t.is_active}\n`;
-      if (t.projects) text += `   Project: ${t.projects.name}\n`;
-      if (t.task_lists) text += `   Task List: ${t.task_lists.name}\n`;
-      if (t.location_description) text += `   Location: ${t.location_description}\n`;
-      text += '\n';
-    });
-    return { content: [{ type: 'text', text }] };
-  }
-);
-
-// Tool 30: Get Scan History
-server.registerTool(
-  'tascan_get_scan_history',
-  {
-    title: 'Get Scan History',
-    description: 'Get scan event history for a registered NFC tag — timestamps, GPS coordinates, and accuracy for each scan',
-    inputSchema: {
-      tag_id: z.string().describe('Tag registry ID (from tascan_list_tags)'),
-      limit: z.number().optional().describe('Max results (default 50)')
-    },
-    annotations: { readOnlyHint: true, destructiveHint: false }
-  },
-  async ({ tag_id, limit }) => {
-    const path = `/tags/${tag_id}/scans` + (limit ? `?limit=${limit}` : '');
-    const result = await apiCall('GET', path);
-    const scans = result.data;
-    if (!scans.length) return { content: [{ type: 'text', text: 'No scans recorded for this tag.' }] };
-    let text = `${scans.length} scan(s):\n\n`;
-    scans.forEach((s, i) => {
-      text += `${i+1}. ${s.scanned_at}`;
-      if (s.gps_lat && s.gps_lng) text += ` — GPS: ${s.gps_lat.toFixed(6)}, ${s.gps_lng.toFixed(6)} (±${Math.round(s.gps_accuracy || 0)}m)`;
-      text += '\n';
-    });
-    return { content: [{ type: 'text', text }] };
-  }
-);
-
+});
 
-// ─── Start Server ──────────────────────────────────────────
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);