tascan-mcp 2.3.0 → 2.4.0

package/index.js

@@ -46,7 +46,7 @@ async function apiCall(method, path, body) {
 // ─── Server Setup ──────────────────────────────────────────
 const server = new McpServer({
   name: 'tascan',
-  version: '2.0.0'
+  version: '2.4.0'
 });
 
 
@@ -860,6 +860,94 @@ server.registerTool(
 );
 
 
+// ─── 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();

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "tascan-mcp",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "mcpName": "io.github.snowbikemike/tascan-mcp",
-  "description": "TaScan MCP Server — Closed-loop autonomous operations protocol. 32 tools for projects, tasks, workers, QR codes, AI issue analysis, autonomous remediation dispatch, and multi-agent coordination. 10 patents filed (265 claims). Task. Scan. Done.",
+  "description": "TaScan MCP Server — Closed-loop autonomous operations protocol. 30 tools for projects, tasks, workers, QR codes, NFC tag registry, scan verification, AI issue analysis, and autonomous remediation dispatch. 12 patents filed (335+ claims). Task. Scan. Done.",
   "type": "module",
   "main": "index.js",
   "bin": {