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

npm install tascan-mcp

Or run directly with npx:

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):

{
  "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

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

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

... [View full README on GitHub](https://github.com/snowbikemike/tascan-mcp#readme)