tascan-mcp 2.2.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,7 +12,7 @@ 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
 
@@ -83,7 +83,7 @@ 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
@@ -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/package.json

@@ -1,8 +1,8 @@
 {
   "name": "tascan-mcp",
-  "version": "2.2.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": {