tascan-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Edward Love II / Love Productions LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,199 @@
+# TaScan MCP Server
+
+AI agent integration for [TaScan](https://tascan.io) — the universal task protocol platform. Manage projects, events, tasks, workers, QR codes, templates, and completion reports through Claude, GitHub Copilot, or any MCP-compatible AI client.
+
+**Scan. Task. Done.**
+
+## What is TaScan?
+
+TaScan is a zero-download task assignment and verification platform for physical-world work. Workers scan a QR code, complete tasks with photo verification, and managers get real-time completion reports — no app download, no login, no training required.
+
+Industries: live events, construction, hospitality, warehousing, property management, healthcare, aviation, FEMA disaster response, and more.
+
+## Installation
+
+```bash
+npm install tascan-mcp
+```
+
+Or run directly with npx:
+
+```bash
+npx tascan-mcp
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `TASCAN_API_KEY` | Yes | Your TaScan API key (generate in Admin Portal > Team > API Keys) |
+| `TASCAN_API_URL` | No | API base URL (default: `https://tascan-live-event.netlify.app/api/v1`) |
+
+### Claude Desktop
+
+Add to your Claude Desktop config file (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "tascan": {
+      "command": "npx",
+      "args": ["-y", "tascan-mcp"],
+      "env": {
+        "TASCAN_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add tascan -- npx -y tascan-mcp
+```
+
+Then set your API key in the environment.
+
+## Tools (22)
+
+### Projects
+| Tool | Description | Type |
+|------|-------------|------|
+| `tascan_list_projects` | List all projects in the organization | Read |
+| `tascan_get_project` | Get details of a specific project | Read |
+| `tascan_create_project` | Create a new project | Create |
+| `tascan_update_project` | Update project name, location, status, dates | Update |
+| `tascan_delete_project` | Delete a project and all its contents | Delete |
+
+### Events (Task Lists)
+| Tool | Description | Type |
+|------|-------------|------|
+| `tascan_list_events` | List all events within a project | Read |
+| `tascan_get_event` | Get event details including tasks | Read |
+| `tascan_create_event` | Create a new event in a project | Create |
+| `tascan_update_event` | Update event name, description, modes | Update |
+| `tascan_delete_event` | Delete an event and all its tasks | Delete |
+
+### Tasks
+| Tool | Description | Type |
+|------|-------------|------|
+| `tascan_list_tasks` | List all tasks in an event | Read |
+| `tascan_get_task` | Get task details including completions | Read |
+| `tascan_add_tasks` | Bulk-create tasks in an event | Create |
+| `tascan_update_task` | Update task title, type, flags, order | Update |
+| `tascan_delete_task` | Delete a task and its completions | Delete |
+
+### Workers
+| Tool | Description | Type |
+|------|-------------|------|
+| `tascan_list_workers` | List all workers in the organization | Read |
+| `tascan_create_worker` | Create a new worker profile | Create |
+| `tascan_update_worker` | Update worker name, phone, email | Update |
+
+### Operations
+| Tool | Description | Type |
+|------|-------------|------|
+| `tascan_generate_qr` | Generate a QR code for an event | Create |
+| `tascan_apply_template` | Apply a pre-built template to an event | Create |
+| `tascan_list_templates` | List available task templates | Read |
+| `tascan_get_report` | Get completion report for an event | Read |
+
+## Usage Examples
+
+### Example 1: Set up a construction site inspection
+
+```
+User: Create a construction project for the Downtown Tower site and set up a daily safety inspection with tasks for PPE check, fall protection, scaffolding inspection, and fire extinguisher check. Make all tasks safety checkpoints that require photos.
+
+Claude will:
+1. Call tascan_create_project with name "Downtown Tower" and location "123 Main St"
+2. Call tascan_create_event with name "Daily Safety Inspection"
+3. Call tascan_add_tasks with 4 safety checkpoint tasks requiring photos
+4. Call tascan_generate_qr to create a scannable QR code for the foreman
+```
+
+### Example 2: Check event completion status
+
+```
+User: How's the hotel room turnover going for the Marriott project? Which rooms still need to be finished?
+
+Claude will:
+1. Call tascan_list_projects to find the Marriott project
+2. Call tascan_list_events to find active room turnovers
+3. Call tascan_get_report for each event to show completion rates
+4. Summarize which tasks are incomplete and which workers are assigned
+```
+
+### Example 3: Use templates to quickly deploy an event
+
+```
+User: We have a warehouse receiving shipment coming in tomorrow. Set up the standard receiving checklist.
+
+Claude will:
+1. Call tascan_list_templates with category "logistics" to find available templates
+2. Call tascan_create_project for the warehouse
+3. Call tascan_create_event for the receiving session
+4. Call tascan_apply_template with the "warehouse-receiving" template slug
+5. Call tascan_generate_qr for the receiving dock crew
+```
+
+### Example 4: Manage workers across multiple events
+
+```
+User: Show me all our workers and which events they've completed this week. Flag anyone with a reliability score below 80%.
+
+Claude will:
+1. Call tascan_list_workers to get all worker profiles
+2. Call tascan_list_projects and tascan_list_events to enumerate active events
+3. Call tascan_get_report for each event to check worker completions
+4. Analyze completion data and flag underperforming workers
+```
+
+## Task Types
+
+Tasks support multiple response types:
+
+| Type | Description |
+|------|-------------|
+| `checkbox` | Simple done/not-done (default) |
+| `photo` | Requires photo upload to complete |
+| `text` | Free-text response |
+| `number` | Numeric response |
+| `date` | Date selection |
+| `choice` | Multiple choice selection |
+
+Tasks can also be flagged as:
+- **Safety checkpoints** (`is_safety_checkpoint: true`) — highlighted in red, cannot be skipped
+- **Photo required** (`requires_photo: true`) — worker must attach a photo to complete
+
+## Getting an API Key
+
+1. Log in to the [TaScan Admin Portal](https://tascan-live-event.netlify.app)
+2. Navigate to **Team** in the sidebar
+3. Scroll to **API Keys**
+4. Click **Generate API Key**
+5. Copy the key (it's only shown once)
+6. Set it as `TASCAN_API_KEY` in your environment
+
+API keys are scoped to your organization and support rate limiting (60 requests/minute).
+
+## Privacy Policy
+
+TaScan collects and processes task completion data, worker information (name, phone, email), GPS coordinates (with consent), and photos uploaded during task completion. Data is stored securely in Supabase with row-level security policies. API access is authenticated and rate-limited.
+
+For the full privacy policy, visit: https://tascan.io/privacy
+
+For data deletion requests or privacy inquiries, contact: Michael@TaScan.io
+
+## Support
+
+- **Email:** Michael@TaScan.io
+- **Website:** https://tascan.io
+- **Issues:** https://github.com/snowbikemike/tascan-mcp/issues
+
+## License
+
+MIT License - Copyright (c) 2026 Michael Edward Love II / Love Productions LLC

package/index.js

@@ -0,0 +1,674 @@
+#!/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)
+// ============================================================
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const API_BASE = process.env.TASCAN_API_URL || 'https://tascan-live-event.netlify.app/api/v1';
+const API_KEY = process.env.TASCAN_API_KEY || '';
+
+if (!API_KEY) {
+  console.error('TASCAN_API_KEY environment variable is required');
+  process.exit(1);
+}
+
+// ─── API Helper ────────────────────────────────────────────
+async function apiCall(method, path, body) {
+  const url = API_BASE + path;
+  const opts = {
+    method,
+    headers: {
+      'Authorization': 'Bearer ' + API_KEY,
+      'Content-Type': 'application/json'
+    }
+  };
+
+  if (body && (method === 'POST' || method === 'PUT')) {
+    opts.body = JSON.stringify(body);
+  }
+
+  const resp = await fetch(url, 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: '1.0.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.',
+    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('Task type (default: checkbox)'),
+        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('Task type'),
+      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)}`
+      }]
+    };
+  }
+);
+
+
+// ─── Start Server ──────────────────────────────────────────
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch(err => {
+  console.error('TaScan MCP server error:', err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "tascan-mcp",
+  "version": "1.0.0",
+  "description": "TaScan MCP Server — AI agent integration for the universal task protocol platform. Manage projects, events, tasks, workers, QR codes, templates, and reports. Scan. Task. Done.",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "tascan-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "zod": "^4.3.6"
+  },
+  "keywords": [
+    "tascan",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "task-management",
+    "qr-code",
+    "field-operations",
+    "workforce",
+    "pwa",
+    "claude"
+  ],
+  "author": {
+    "name": "Michael Edward Love II",
+    "email": "Michael@TaScan.io",
+    "url": "https://tascan.io"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/snowbikemike/tascan-mcp.git"
+  },
+  "homepage": "https://tascan.io",
+  "bugs": {
+    "url": "https://github.com/snowbikemike/tascan-mcp/issues",
+    "email": "Michael@TaScan.io"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}