tascan-mcp 2.1.0 → 2.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 AI agent integration for [TaScan](https://tascan.io) — the closed-loop autonomous operations protocol. Manage projects, events, tasks, workers, QR codes, templates, completion reports, and AI-powered issue resolution through Claude, GitHub Copilot, or any MCP-compatible AI client.
 
-**Scan. Task. Done.**
+**Task. Scan. Done.**
 
 ## What is TaScan?
 
@@ -12,14 +12,14 @@ When something breaks, AI analyzes the issue, generates fix instructions, and di
 
 Industries: live events, construction, hospitality, warehousing, property management, healthcare, aviation, FEMA disaster response, and more.
 
-**Patent Pending** — USPTO #63/995,189 & #63/996,023
+**10 Provisional Patents Filed** — 265 claims, ~1000+ pages of specification. USPTO Applications #63/995,189 through #64/001,286.
 
 ## Quickest Start: Claude.ai / Claude Mobile
 
 No install required. Add TaScan as a custom connector in Claude:
 
 1. **Settings > Connectors > Add custom connector**
-2. Enter: `https://tascan-live-event.netlify.app/mcp`
+2. Enter: `https://app.tascan.io/mcp`
 3. First time you use a tool, sign in with your TaScan email and password
 
 That's it. Works on claude.ai and Claude mobile. Same sign-in experience as GitHub, Netlify, and Supabase connectors.
@@ -45,7 +45,7 @@ npx tascan-mcp
 | 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`) |
+| `TASCAN_API_URL` | No | API base URL (default: `https://app.tascan.io/api/v1`) |
 
 ### Claude Desktop
 
@@ -78,12 +78,12 @@ Then set your API key in the environment.
 TaScan MCP is also available as a remote server — no install, no API key needed:
 
 ```
-https://tascan-live-event.netlify.app/mcp
+https://app.tascan.io/mcp
 ```
 
 Add as a custom connector in Claude (Settings > Connectors). When you first use a tool, you'll be redirected to sign in with your TaScan email and password — just like connecting GitHub or Netlify. OAuth 2.0 with PKCE handles everything automatically.
 
-## Tools (27)
+## Tools (32)
 
 ### Projects
 | Tool | Description | Type |
@@ -133,9 +133,22 @@ Add as a custom connector in Claude (Settings > Connectors). When you first use
 | `tascan_list_issues` | List field-reported issues with filtering by status, category, severity | Read |
 | `tascan_analyze_issue` | AI classifies issue severity, identifies root cause, and scores urgency | AI |
 | `tascan_recommend_fix` | AI generates ranked remediation tasks with step-by-step instructions | AI |
-| `tascan_dispatch_instruction` | Multi-channel delivery of fix instructions to workers (SMS, push, QR) | Create |
 | `tascan_auto_resolve` | Full closed loop in ONE call — issue in, AI analyzes, fix dispatched, loop closes | AI |
 
+### Communications
+| Tool | Description | Type |
+|------|-------------|------|
+| `tascan_dispatch_instruction` | Multi-channel delivery of instructions to workers (SMS, email, QR) | Create |
+| `tascan_send_task_email` | Send task links and notifications via email | Create |
+| `tascan_complete_task` | Mark a task as completed with optional response data | Update |
+
+### AI Agent Coordination (Patent #10)
+| Tool | Description | Type |
+|------|-------------|------|
+| `tascan_list_agents` | List registered AI agents in the system | Read |
+| `tascan_register_agent` | Register a new AI agent with capabilities | Create |
+| `tascan_dispatch_to_agent` | Route a task to a specific AI agent for execution | Create |
+
 ## Usage Examples
 
 ### Example 1: Set up a construction site inspection
@@ -204,7 +217,7 @@ Tasks can also be flagged as:
 
 ## Getting an API Key
 
-1. Log in to the [TaScan Admin Portal](https://tascan-live-event.netlify.app)
+1. Log in to the [TaScan Admin Portal](https://app.tascan.io)
 2. Navigate to **Team** in the sidebar
 3. Scroll to **API Keys**
 4. Click **Generate API Key**
@@ -213,6 +226,33 @@ Tasks can also be flagged as:
 
 API keys are scoped to your organization and support rate limiting (60 requests/minute).
 
+## Troubleshooting
+
+**"Connection failed" or OAuth redirect issues**
+- Verify you're using the correct URL: `https://app.tascan.io/mcp`
+- Clear your browser cache and try reconnecting
+- If using Claude Desktop, restart the app after adding the connector
+
+**"Unauthorized" or 401 errors (local npm install)**
+- Regenerate your API key in Admin Portal > Team > API Keys
+- Confirm `TASCAN_API_KEY` is set in your environment (not just in the config file)
+- Keys are organization-scoped — make sure you're using a key from the correct org
+
+**Tools not showing up in Claude**
+- Disconnect and reconnect the TaScan connector
+- For Claude Code: run `claude mcp list` to verify the server is registered
+- Check that your TaScan account has an active organization (free tier is fine)
+
+**"Rate limited" errors**
+- Default limit is 60 requests/minute per API key
+- Pro and Business tiers have higher limits
+- Batch operations (like `tascan_add_tasks`) are more efficient than individual calls
+
+**Task completions not appearing**
+- Workers must submit via the task link (QR scan or direct URL)
+- Photo-required tasks won't show as complete until the photo uploads
+- Check the event's response mode (single vs. multi-response)
+
 ## 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.

package/index.js

@@ -10,7 +10,7 @@ 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_BASE = process.env.TASCAN_API_URL || 'https://app.tascan.io/api/v1';
 const API_KEY = process.env.TASCAN_API_KEY || '';
 
 if (!API_KEY) {
@@ -134,13 +134,13 @@ server.registerTool(
   'tascan_add_tasks',
   {
     title: 'Add Tasks',
-    description: 'Add one or more tasks to an event (task list). Supports bulk creation.',
+    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('Task type (default: checkbox)'),
+        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')
@@ -531,7 +531,7 @@ server.registerTool(
       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'),
+      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')

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "tascan-mcp",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "mcpName": "io.github.snowbikemike/tascan-mcp",
-  "description": "TaScan MCP Server — Closed-loop autonomous operations protocol. 27 tools for projects, tasks, workers, QR codes, AI issue analysis, and autonomous remediation dispatch. Patent pending. Scan. Task. Done.",
+  "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.",
   "type": "module",
   "main": "index.js",
   "bin": {