io.github.snowbikemike/tascan-mcp

Official32 tools

by snowbikemike · JavaScript

TaScan

Universal task protocol — manage projects, tasks, workers, QR codes, and reports.

Manage projects, tasks, workers, QR codes, and reports through a universal task protocol.

Captured live from the server via tools/list.

tascan_list_projects

List all TaScan projects in the organization

No parameters.

tascan_create_project

Create a new TaScan project (top-level container for events)

Parameters (2)

namestringrequired
Project name
locationstring
Project location / venue

tascan_get_project

Get details of a specific project

Parameters (1)

project_idstringrequired
Project ID

tascan_update_project

Update a project (name, location, status, dates)

Parameters (6)

project_idstringrequired
Project ID
namestring
New name
locationstring
New location
statusstring
Status
start_datestring
Start date (ISO)
end_datestring
End date (ISO)

tascan_delete_project

Delete a project and all its events, tasks, and completions. This action is irreversible.

Parameters (1)

project_idstringrequired
Project ID to delete

tascan_create_event

Create a new event (task list) within a project. Supports team_mode (shared completions) and multi_instance (each worker gets isolated copy — great for surveys, onboarding, info collection). team_mode and multi_instance cannot both be true.

Parameters (5)

project_idstringrequired
Project ID
namestringrequired
Event name
descriptionstring
Event description
team_modeboolean
Team mode — shared completions
multi_instanceboolean
Multi-instance — each worker gets isolated copy

tascan_list_events

List all events (task lists) within a project

Parameters (1)

project_idstringrequired
Project ID

tascan_get_event

Get details of a specific event (task list) including its tasks

Parameters (1)

list_idstringrequired
Task list (event) ID

tascan_update_event

Update an event / task list (name, description, team_mode, multi_instance, timer_mode). team_mode and multi_instance cannot both be true.

Parameters (6)

list_idstringrequired
Task list (event) ID
namestring
New name
descriptionstring
New description
team_modeboolean
Team mode — shared completions
multi_instanceboolean
Multi-instance — each worker gets isolated copy
timer_modestring
Timer mode (auto or manual)

tascan_delete_event

Delete an event (task list) and all its tasks and completions. This action is irreversible.

Parameters (1)

list_idstringrequired
Task list (event) ID to delete

tascan_add_tasks

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. NOTE: To dispatch tasks to the Claude Code agent running on Mike's PC, use tascan_dispatch_to_agent instead — it routes directly to the agent's inbox with zero configuration needed.

Parameters (2)

list_idstringrequired
Task list (event) ID
tasksarrayrequired
Array of tasks to create

tascan_dispatch_to_agent

PREFERRED tool for sending work to an AI agent. Dispatches a task to the agent's inbox — picked up and executed automatically. No list ID needed. Supports prefixes: CODE: SHELL: RESEARCH: WRITE: PLAN: for routing. Use "agent" param to target a specific agent (default: claude-code-local). Use tascan_list_agents to discover available agents.

Parameters (3)

taskstringrequired
The task description. Prefix with CODE: SHELL: RESEARCH: WRITE: PLAN: for routing, or just plain text.
agentstring
Agent ID or name to dispatch to (default: claude-code-local). Use tascan_list_agents to see options.
prioritystring
Priority level (default: normal)

tascan_list_agents

List all registered AI agents with their capabilities, inbox IDs, and status. Like reading input labels on a video matrix — discover which agents are available and what they can do before dispatching work.

No parameters.

tascan_register_agent

Register a new AI agent in the agent registry. The agent will appear in tascan_list_agents and can receive dispatched tasks. Self-registration for AI agents joining the TaScan network.

Parameters (9)

idstringrequired
Unique agent ID (e.g. "my-agent-1")
namestringrequired
Display name (e.g. "Research Bot")
typestringrequired
Agent type
modelstring
Model powering this agent (e.g. "claude-sonnet-4-6")
worker_idstring
TaScan worker ID for this agent
inbox_idstringrequired
Task list ID this agent monitors for new tasks
capabilitiesarrayrequired
Task type prefixes this agent handles (e.g. ["RESEARCH", "WRITE"])
locationstring
Where the agent runs (e.g. "AWS us-east-1")
descriptionstring
What this agent does

tascan_list_tasks

List all tasks in an event (task list)

Parameters (1)

list_idstringrequired
Task list (event) ID

tascan_get_task

Get details of a specific task including completions

Parameters (1)

task_idstringrequired
Task ID

tascan_update_task

Update a task (title, description, response_type, flags, sort_order)

Parameters (7)

task_idstringrequired
Task ID
titlestring
New title
descriptionstring
New description
response_typestring
See tascan_add_tasks for guidance. "text" for info collection, "photo" for visual proof, "checkbox" for yes/no only.
is_safety_checkpointboolean
Safety-critical flag
requires_photoboolean
Require photo
sort_ordernumber
Sort position

tascan_delete_task

Delete a specific task and its completions. This action is irreversible.

Parameters (1)

task_idstringrequired
Task ID to delete

tascan_complete_task

Complete a task on behalf of a worker. Inserts a completion record and timer event. Use this to simulate or record task completions via the API.

Parameters (4)

task_idstringrequired
Task ID to complete
worker_idstringrequired
Worker ID performing the completion
notesstring
Optional completion notes
response_valuestring
Response value (for text/number/choice tasks)

tascan_list_workers

List all workers (taskees) in the organization

No parameters.

tascan_create_worker

Create a new worker (taskee) in the organization

Parameters (3)

namestringrequired
Worker name
phonestring
Phone number
emailstring
Email

tascan_update_worker

Update a worker profile (name, phone, email)

Parameters (4)

worker_idstringrequired
Worker ID
namestring
New name
phonestring
New phone
emailstring
New email

tascan_generate_qr

Generate a QR code for a task list (event) that workers can scan to access tasks

Parameters (1)

list_idstringrequired
Task list (event) ID

tascan_apply_template

Apply a pre-built template to a task list, adding all template tasks

Parameters (2)

list_idstringrequired
Task list (event) ID
template_slugstringrequired
Template slug (e.g. "conference-load-in", "warehouse-receiving")

tascan_list_templates

List available task templates (built-in and saved)

Parameters (1)

categorystring
Filter by category (e.g. "live-events", "hospitality", "logistics")

tascan_get_report

Get completion report for a task list (event) including task status, completions, workers, and photos

Parameters (1)

list_idstringrequired
Task list (event) ID

tascan_list_issues

List all issues for a task list (event). Returns open, acknowledged, and resolved issues with severity, type, and category. Use this to discover issues that need AI analysis via tascan_analyze_issue.

Parameters (1)

list_idstringrequired
Task list (event) ID

tascan_analyze_issue

Step 1 of the Closed-Loop Autonomous Operations Protocol. Retrieves full issue context including worker info, message thread, project history, and recent similar issues. Use this data to reason about the root cause and generate a remediation plan. Also supports server-side AI analysis via POST (calls Anthropic API directly).

Parameters (2)

issue_idstringrequired
Issue ID to analyze
server_side_aiboolean
If true, the server calls Anthropic API directly for AI analysis (default: false — returns raw data for MCP client to analyze)

tascan_recommend_fix

Step 2 of the Closed-Loop Autonomous Operations Protocol. Post an AI-generated recommendation to an issue thread. Accepts both a text recommendation and an optional structured_recommendation object with task definitions for auto-dispatch. The recommendation is persisted in the AI audit trail.

Parameters (4)

issue_idstringrequired
Issue ID to recommend a fix for
recommendationstringrequired
The AI-generated recommendation text (clear, actionable instructions)
structured_recommendationobject
Optional structured recommendation with tasks for auto-dispatch. Format: { recommendation_summary, confidence_score, tasks: [{ title, description, response_type, requires_photo, is_safety_checkpoint, sort_order }], estimated_duration_minutes, required_responder_role }
ai_agentstring
Name of the AI agent posting (default: TaScan AI)

tascan_dispatch_instruction

Step 3 of the Closed-Loop Autonomous Operations Protocol. Dispatches remediation to the worker via MULTI-CHANNEL delivery: (1) issue thread message, (2) in-app notification, (3) progress feed update, (4) SMS if phone on file, (5) optional remediation task list creation. Closes the loop from digital AI analysis to physical worker execution.

Parameters (7)

issue_idstringrequired
Issue ID this instruction relates to
instructionstringrequired
Clear, actionable instruction for the worker to execute
worker_idstring
Target worker ID (defaults to the worker who reported the issue)
remediation_tasksarray
Optional array of tasks to create as a remediation task list. Each: { title, description, response_type, requires_photo, is_safety_checkpoint, sort_order }
recommendation_summarystring
One-line summary for the task list description
send_smsboolean
Send SMS to worker (default: true if phone on file)
ai_agentstring
Name of the AI agent dispatching (default: TaScan AI)

tascan_auto_resolve

FULL Closed-Loop Autonomous Operations Protocol in one call. Server-side AI analyzes the issue, generates remediation tasks, creates a task list, and dispatches to the worker — all without human intervention. This executes Patent Claim 7: autonomous operations from issue detection through physical-world instruction delivery.

Parameters (1)

issue_idstringrequired
Issue ID to auto-resolve

tascan_send_task_email

Send a branded TaScan task notification email via SendGrid. Can notify anyone about a specific task list or task. Includes QR code, task summary, and "Open in TaScan" button.

Parameters (7)

to_emailstringrequired
Recipient email address
to_namestring
Recipient display name
list_idstringrequired
Task list (event) ID
task_idstring
Optional specific task ID to highlight
subjectstring
Custom email subject (defaults to auto-generated)
messagestring
Optional custom message to include in the email body
include_qrboolean
Include QR code for the task list in the email (default: true)

README.md7 KBView on GitHub

TaScan MCP Server

AI agent integration for TaScan — 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

code

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

code

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

code

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

code

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

Log in to the TaScan Admin Portal
Navigate to Team in the sidebar
Scroll to API Keys
Click Generate API Key
Copy the key (it's only shown once)
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

Install

Configuration

Environment variables

TASCAN_API_KEYrequiredsecret

Your TaScan API key (generate in Admin Portal > Team > API Keys)

TASCAN_API_URL

TaScan API base URL (default: https://tascan-live-event.netlify.app/api/v1)

claude_desktop_config.json

{
  "mcpServers": {
    "tascan-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tascan-mcp@1.0.1"
      ],
      "env": {
        "TASCAN_API_KEY": "<YOUR_TASCAN_API_KEY>",
        "TASCAN_API_URL": "<YOUR_TASCAN_API_URL>"
      }
    }
  }
}