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.

Related MCP server: pith

Installation

npm install tascan-mcp

Or run directly with npx:

npx tascan-mcp

Configuration

Environment Variables

Claude Desktop

Add to your Claude Desktop config file (claude_desktop_config.json):

{
  "mcpServers": {
    "tascan": {
      "command": "npx",
      "args": ["-y", "tascan-mcp"],
      "env": {
        "TASCAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add tascan -- npx -y tascan-mcp

Then set your API key in the environment.

Tools (22)

Projects

Events (Task Lists)

Tasks

Workers

Operations

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:

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

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