TaScan
Universal task protocol β manage projects, tasks, workers, QR codes, and reports.
Ask AI about TaScan
Powered by Claude Β· Grounded in docs
I know everything about TaScan. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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 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:
| 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_KEYin 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
