WeTrack Enterprise MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WeTrack Enterprise MCP Server Show me all open tickets in the WeTrack Platform project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WeTrack Enterprise MCP Server š
A Python MCP (Model Context Protocol) Server that exposes the entire WeTrack/VTrack REST API as AI-callable tools ā enabling Claude, Cursor, Gemini, and any MCP-compatible AI assistant to manage projects, tickets, sprints, and more in natural language.
ā What's Included
Module | Tools | Coverage |
š Auth | 7 | Sign-in, sign-out, password, impersonation |
š OAuth | 3 | Microsoft sign-in URL, token setter, callback info |
š« Tickets | 13 | EPIC/STORY/TASK/BUG + support tickets, comments, history |
š Projects | 17 | CRUD + overview, reports, team, files, folders |
š Sprints | 5 | Full sprint lifecycle management |
š¤ Users | 7 | Create (single/bulk), update, invite management |
š¢ Clients | 7 | Client orgs, organisations, member assignment |
š Dashboard | 1 | Aggregated KPIs and analytics |
š Reports | 11 | Unified reports, My Work, My Sprint, widget CRUD |
š Notifications | 4 | Feed, unread count, mark read |
š Search | 1 | Global search across all entities |
šļø Master Data | 17 | Statuses, priorities, categories, types, products, timezones |
š§© Metadata | 6 | Custom field definitions |
š¤ Uploads | 2 | S3 presigned URLs, upload instructions |
ā” Webhooks & Cron | 3 | SLA check trigger, sprint burndown snapshot, email webhook info |
Total | 110 | Complete WeTrack Enterprise API coverage |
Related MCP server: Lazy LLMs Project Management MCP Server
š ļø Requirements
Python 3.11+
uv (recommended) or pip
š Quick Start
1. Install uv (if not already installed)
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh2. Set up credentials
# Copy the template
copy .env.example .env # Windows
cp .env.example .env # macOS/Linux
# Edit .env and fill in your WeTrack credentials:
# WETRACK_BASE_URL=https://wetrack-two.vercel.app
# WETRACK_EMAIL=your@email.com
# WETRACK_PASSWORD=YourPassword1233. Install dependencies
uv sync4. Run the MCP server
# stdio mode (for Claude Desktop / Cursor)
uv run python -m wetrack_mcp.server
# SSE mode (for HTTP/web clients)
MCP_TRANSPORT=sse uv run python -m wetrack_mcp.serverš³ Docker & EC2 Deployment
1. Run with Docker Compose (Recommended for EC2)
# Clone the repository
git clone https://github.com/subbuyalla/wetrack-mcp.git
cd wetrack-mcp
# Create .env from template and configure credentials
cp .env.example .env
nano .env
# Build and start in background
docker compose up -d --build2. Check Container Logs & Health
# Check running status
docker compose ps
# View live logs
docker compose logs -fThe MCP SSE server listens on port 8000:
SSE URL:
http://<YOUR_EC2_PUBLIC_IP>:8000/sseMessage endpoint:
http://<YOUR_EC2_PUBLIC_IP>:8000/messages/
Note for EC2 Security Groups: Ensure your AWS EC2 Security Group allows inbound TCP traffic on port
8000(or place behind Nginx/ALB on port 443 with SSL).
š Connecting to Any AI Platform
The WeTrack MCP server is universal and connects to all major AI assistants and IDEs:
1. Claude Desktop
Option A: Connect to Cloud EC2 Deployment (Zero local setup for teammates)
Open %APPDATA%\Claude\claude_desktop_config.json (or click Settings ā Developer ā Edit config):
{
"mcpServers": {
"wetrack": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"http://<YOUR_EC2_PUBLIC_IP>:8000/sse",
"--allow-http"
]
}
}
}Option B: Run Locally on your computer (stdio)
{
"mcpServers": {
"wetrack": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/wetrack-mcp",
"python",
"-m",
"wetrack_mcp.server"
],
"env": {
"WETRACK_BASE_URL": "https://wetrack-two.vercel.app",
"WETRACK_EMAIL": "your@email.com",
"WETRACK_PASSWORD": "yourpassword"
}
}
}
}Restart Claude Desktop after saving.
2. Cursor IDE
Cursor supports native remote SSE connections with zero Node.js or local installation required:
Open Cursor Settings (
Ctrl + Shift + JorCmd + Shift + J) ā MCP.Click + Add New MCP Server.
Fill in:
Name:
wetrackType:
sseURL:
http://<YOUR_EC2_PUBLIC_IP>:8000/sse
Click Add. All 110 tools will instantly show green in Composer!
3. VS Code (Cline / Roo Code / Continue)
In your extension's MCP configuration settings (cline_mcp_settings.json or config.json):
{
"mcpServers": {
"wetrack": {
"url": "http://<YOUR_EC2_PUBLIC_IP>:8000/sse",
"transport": "sse"
}
}
}4. Windsurf (Codeium)
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"wetrack": {
"serverUrl": "http://<YOUR_EC2_PUBLIC_IP>:8000/sse"
}
}
}5. ChatGPT
Method A: Custom GPT Action (Easiest & Most Popular)
In ChatGPT, click Explore GPTs ā + Create.
Go to the Configure tab ā scroll down and click Create new action.
Import or paste the schema from
chatgpt-actions-schema.yaml.Configure Authentication (Bearer token or session cookie).
Save the GPT ā you can now manage WeTrack tickets and projects directly in ChatGPT web or mobile!
Method B: ChatGPT Developer Mode (MCP)
Open ChatGPT Settings ā Developer Mode / Connectors.
Select Add MCP Server and enter your EC2 HTTPS URL.
6. Python & LangChain AI Agents
Integrate WeTrack tools directly into custom LangChain / LangGraph workflows:
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
async with MultiServerMCPClient(
{"wetrack": {"url": "http://<YOUR_EC2_PUBLIC_IP>:8000/sse", "transport": "sse"}}
) as client:
tools = client.get_tools()
agent = create_react_agent(model, tools)
response = await agent.ainvoke({"messages": "List open tickets in WeTrack"})š Authentication
Authentication is fully automatic:
The server reads
WETRACK_EMAILandWETRACK_PASSWORDfrom.envOn the first tool call, it auto-logs in and stores the JWT token
On
401 Unauthorized, it automatically re-logs in and retriesYou can also call
wetrack_sign_inmanually from the AI chat
Example prompts after setup:
"Show me all open tickets in the WeTrack Platform project"
"Create a TASK titled 'Fix login page bug' in the WTP project with High priority"
"What sprints are currently in progress?"
"List all users in the organisation"š Project Structure
wetrack-mcp/
āāā src/wetrack_mcp/
ā āāā server.py ā Entry point
ā āāā auth.py ā JWT token management
ā āāā client.py ā HTTP client with auto-auth
ā āāā config.py ā Environment config
ā āāā tools/
ā āāā auth_tools.py
ā āāā ticket_tools.py
ā āāā project_tools.py
ā āāā sprint_tools.py
ā āāā user_tools.py
ā āāā client_tools.py
ā āāā dashboard_tools.py
ā āāā report_tools.py
ā āāā notification_tools.py
ā āāā search_tools.py
ā āāā master_tools.py
ā āāā metadata_tools.py
āāā .env.example
āāā .env ā Your credentials (gitignored)
āāā pyproject.tomlš Environment Variables
Variable | Required | Description |
| Yes | API base URL (staging or production) |
| Yes* | Login email |
| Yes* | Login password |
| No | Pre-set JWT token (skips auto-login) |
| No |
|
| No | SSE host (default: |
| No | SSE port (default: |
*Required unless WETRACK_TOKEN is set.
š Production Switch
When ready to go to production, just update .env:
WETRACK_BASE_URL=https://your-production-url.comNo code changes needed.
š Switching to TypeScript
Once testing is complete, the TypeScript port will use:
@modelcontextprotocol/sdkaxiosfor HTTPzodfor validation
The tool names and behaviors will be identical.
Available Tools
110 toolswetrack_add_client_membersC
Assign or update the members associated with a client organisation.
Args: client_id: The client ID. member_ids: List of integer user IDs to associate with this client e.g. [1, 2, 5].
Inputs: client_id (required), member_ids (required). Returns: result
wetrack_add_project_fileA
Register an already-uploaded S3 file in project files. Upload to S3 first using wetrack_get_upload_presign_url, then call this.
Args: project_id: The project UUID. file_name: The file name e.g. 'requirements.pdf'. file_size: File size in bytes. s3_url: The S3 URL returned from the upload. file_type: MIME type e.g. 'application/pdf'. folder_id: UUID of the folder to place the file in.
Inputs: s3_url (required), file_name (required), file_size (required), project_id (required), +2 more. Returns: result
wetrack_add_ticket_attachmentA
Add a file attachment to a ticket (the file must already be uploaded to S3). Use wetrack_get_upload_presign_url to upload to S3 first, then call this.
Args: ticket_id: The ticket UUID. url: S3 URL of the uploaded file. file_name: Original file name e.g. 'screenshot.png'. file_size: File size in bytes. file_type: MIME type e.g. 'image/png'.
Inputs: url (required), file_name (required), file_size (required), ticket_id (required), +1 more. Returns: result
wetrack_add_ticket_commentB
Add a comment to a ticket.
Args: ticket_id: The ticket UUID. comment: Comment text e.g. 'Investigating the issue now.'
Inputs: comment (required), ticket_id (required). Returns: result
wetrack_bulk_create_usersA
Bulk create multiple user accounts at once.
Args: users: List of user objects. Each must have: {first_name, last_name, email, role} ā and optionally user_name. skip_invite_email: Set True for SSO-only users who won't use password login.
Example users list: [ {"first_name": "Alice", "last_name": "Wong", "email": "alice@co.com", "role": "VITHI_USER"}, {"first_name": "Bob", "last_name": "Jones", "email": "bob@co.com", "role": "EMPLOYEE"} ]
Inputs: users (required), skip_invite_email. Returns: result
wetrack_change_passwordA
Change the logged-in user's password.
Args: current_password: The user's current password. new_password: The new password to set. confirm_password: Must match new_password exactly.
Inputs: new_password (required), confirm_password (required), current_password (required). Returns: result
wetrack_create_clientA
Create a new client organisation.
Args: name: Organisation name e.g. 'Acme Corp'. email: Primary contact email e.g. 'contact@acme.com'. contact_name: Primary contact person name e.g. 'John Doe'. address: Physical address e.g. '123 Tech Park'. phone: Organisation phone number. contact_email: Contact person's email (if different from org email). contact_phone: Contact person's phone. code: Short org code e.g. 'AC'. country: Country name. timezone_id: Timezone integer ID (get from wetrack_list_timezones).
Inputs: name (required), email (required), address (required), contact_name (required), +6 more. Returns: result
wetrack_create_metadata_fieldA
Create a new custom metadata field definition.
Args: resource_type: What the field belongs to ā 'TICKET', 'PROJECT', or 'SPRINT'. label: Field label e.g. 'Cost Center'. field_type: Field input type ā 'TEXT', 'NUMBER', 'DATE', 'BOOLEAN', 'SELECT', or 'MULTI_SELECT'. ticket_type: Required when resource_type is 'TICKET' ā 'EPIC', 'STORY', 'TASK', 'BUG'. helper_text: Optional placeholder/helper text shown below the field. is_required: Whether this field is mandatory (default: False). options: Required for SELECT/MULTI_SELECT fields ā list of option objects: [{"label": "Engineering", "value": "eng"}, ...]
Example: resource_type="TICKET", ticket_type="BUG", label="Environment", field_type="SELECT", options=[{"label": "Production", "value": "prod"}, {"label": "Staging", "value": "staging"}]
Inputs: label (required), field_type (required), resource_type (required), options, +3 more. Returns: result
wetrack_create_organisationB
Create a new organisation.
Args: name: Organisation name e.g. 'Vithi IT Solutions'. email: Contact email e.g. 'contact@vithi.com'. contact_name: Primary contact person e.g. 'Jane Doe'. slug: URL slug e.g. 'vithi'. phone: Phone number.
Inputs: name (required), email (required), contact_name (required), slug, +1 more. Returns: result
wetrack_create_projectA
Create a new project. Sprints are auto-generated from the timeline.
Args: name: Project name e.g. 'WeTrack Platform'. key: Short unique key e.g. 'WTP' (used as ticket prefix). start_date: Project start date ā 'YYYY-MM-DD'. end_date: Project end date ā 'YYYY-MM-DD'. manager_id: UUID of the project manager user. description: Project description text. sprint_duration_weeks: Sprint length in weeks (default: 2). color: Hex color for the project card e.g. '#10B981'. tags: List of tag strings e.g. ['Internal', 'Platform'].
Inputs: key (required), name (required), end_date (required), start_date (required), +5 more. Returns: result
wetrack_create_project_folderA
Create a folder (or sub-folder) inside a project's file storage.
Args: project_id: The project UUID. name: Folder name e.g. '01. Requirements'. parent_folder_id: UUID of parent folder for sub-folders.
Inputs: name (required), project_id (required), parent_folder_id. Returns: result
wetrack_create_sprintA
Create a sprint manually for a project.
Args: project_id: UUID of the project this sprint belongs to. name: Sprint name e.g. 'Sprint 3'. start_date: Start date 'YYYY-MM-DD'. end_date: End date 'YYYY-MM-DD'. goal: Sprint goal description e.g. 'Complete user auth module'. status: Initial status ā 'PLANNED' (default), 'IN_PROGRESS', or 'COMPLETED'.
Inputs: project_id (required), goal, name, status, +2 more. Returns: result
wetrack_create_support_ticketA
Create a legacy support ticket (not an EPIC/STORY/TASK/BUG work item).
Args: title: Ticket title e.g. 'Login issue on portal'. request_status_id: Integer status ID. request_priority_id: Integer priority ID. organisation_id: UUID of the client organisation. project_id: UUID of the project. description: Rich HTML description (up to 2MB). request_type_id: Optional ticket type ID. category_id: Optional category ID. assigned_to: Optional user integer ID to assign. reporting_to: Optional reporter user integer ID. due_date: ISO datetime for due date. start_date: ISO datetime for start. estimate: Estimated hours (float).
Inputs: title (required), project_id (required), organisation_id (required), request_status_id (required), +9 more. Returns: result
wetrack_create_ticket_categoryB
Create a new ticket category.
Args: name: Category name e.g. 'Hardware'. description: Optional description. color: Hex color. icon: Icon identifier.
Inputs: name (required), icon, color, description. Returns: result
wetrack_create_ticket_priorityA
Create a new ticket priority. The code is auto-derived from the name.
Args: name: Priority name e.g. 'Blocker' or 'Very High'. priority_type: Severity bucket ā 'LOW', 'MEDIUM', 'HIGH', or 'CRITICAL'. resource: Resource type ā 'SPRINT', 'TASK', or 'PROJECT'. description: Optional description. color: Hex color. icon: Icon identifier.
Inputs: name (required), resource (required), priority_type (required), icon, +2 more. Returns: result
wetrack_create_ticket_productB
Create a new ticket product.
Args: name: Product name e.g. 'VTrack Fleet'. description: Optional description.
Inputs: name (required), description. Returns: result
wetrack_create_ticket_statusA
Create a new ticket status.
Args: name: Status name e.g. 'In Progress'. category: Lifecycle stage ā 'TO_DO', 'IN_PROGRESS', or 'DONE'. resource: Resource type ā 'SPRINT', 'TASK', or 'PROJECT'. description: Optional description. color: Hex color e.g. '#3B82F6'. icon: Icon identifier. pauses_sla: Whether this status pauses SLA timer (default: False).
Inputs: name (required), category (required), resource (required), icon, +3 more. Returns: result
wetrack_create_ticket_typeA
Create a new ticket type.
Args: name: Type name e.g. 'Bug'. description: Optional description. color: Hex color. icon: Icon identifier.
Inputs: name (required), icon, color, description. Returns: result
wetrack_create_userA
Create a single user account and send an invitation email.
Args: first_name: User's first name e.g. 'Jane'. last_name: User's last name e.g. 'Smith'. email: User's email e.g. 'jane@company.com'. role: Access role ā 'ADMIN', 'VITHI_USER', 'EMPLOYEE', or 'CUSTOMER'. designation: Job title e.g. 'Senior Backend Engineer'. user_name: Optional username override.
Inputs: role (required), email (required), last_name (required), first_name (required), +2 more. Returns: result
wetrack_create_widgetA
Add a report widget to the current user's dashboard.
Args: title: Display title shown on the widget card (non-empty). metric: What to measure ā one of: 'COUNT_OF_TICKETS', 'COUNT_CREATED_VS_COMPLETED', 'AVG_CYCLE_TIME', 'AVG_RESPONSE_TIME', 'AVG_TICKET_AGE', 'SUM_STORY_POINTS', 'SUM_TIME_SPENT', 'COUNT_BLOCKED'. dimension: Group-by dimension ā one of: 'PROJECT', 'SPRINT', 'SPRINT_STATUS', 'ASSIGNEE', 'REPORTER', 'STATUS', 'STATUS_CATEGORY', 'PRIORITY', 'TYPE', 'PARENT', 'DUE_DATE_BUCKET', 'CREATED_DATE', 'RESOLVED_DATE', 'BLOCKED', 'BUG_TYPE'. chart_type: How to render ā 'BAR', 'LINE', 'PIE', 'DONUT', 'TABLE', or 'AREA'. catalog_report_id: Optional id from wetrack_get_reports_catalog to link to a catalog entry (e.g. 'status_breakdown').
Inputs: title (required), metric (required), dimension (required), chart_type (required), +1 more. Returns: result
wetrack_create_work_itemA
Create a new work item ā EPIC, STORY, TASK, or BUG.
Args: ticket_type: 'EPIC', 'STORY', 'TASK', or 'BUG'. title: Work item title (Epic Name / Story Name / Task Name / Bug Title). summary: Short summary of the work item. project_id: UUID of the project this belongs to. priority_id: Integer ID of the priority (get from wetrack_list_ticket_priorities). status_id: Status ID (defaults to 'To Do' if omitted). description: Optional rich text description (HTML supported). Required for BUG. assignees: List of user UUIDs to assign. First becomes primary assignee. start_date: ISO datetime string e.g. '2026-09-01T00:00:00Z'. end_date: ISO datetime string. Must be after start_date. tags: List of string tags. sprint_id: UUID of the sprint to assign this to (optional). story_points: Integer story points. Required for STORY, optional for TASK/BUG. bug_type: Bug category string. Required for BUG type only. parent_id: Integer ID of parent EPIC (for STORY/TASK/BUG only).
Inputs: title (required), summary (required), project_id (required), priority_id (required), +11 more. Returns: result
wetrack_delete_metadata_fieldA
Delete a metadata field definition. Will fail for system-protected fields.
Args: field_id: Integer ID of the metadata field to delete.
Inputs: field_id (required). Returns: result
wetrack_delete_projectA
Soft-delete a project (it becomes inactive but data is retained).
Args: project_id: The project UUID to delete.
Inputs: project_id (required). Returns: result
wetrack_delete_project_fileC
Delete a project file record.
Args: project_id: The project UUID. file_id: The file UUID to delete.
Inputs: file_id (required), project_id (required). Returns: result
wetrack_delete_project_folderC
Delete a folder from a project.
Args: project_id: The project UUID. folder_id: The folder UUID to delete.
Inputs: folder_id (required), project_id (required). Returns: result
wetrack_delete_sprintA
Delete a sprint and unassign all linked tickets back to backlog.
Args: sprint_id: The sprint UUID to delete.
Inputs: sprint_id (required). Returns: result
wetrack_delete_ticket_attachmentB
Delete an attachment from a ticket.
Args: ticket_id: The ticket UUID. attachment_id: The attachment UUID to delete.
Inputs: ticket_id (required), attachment_id (required). Returns: result
wetrack_delete_ticket_priorityA
Soft-delete a ticket priority (sets inactive; data retained). Will fail if active tickets still use this priority.
Args: priority_id: The priority ID to deactivate.
Inputs: priority_id (required). Returns: result
wetrack_delete_ticket_statusA
Soft-delete a ticket status (sets inactive; data is retained). Will fail if active tickets are still using this status.
Args: status_id: The status ID to deactivate.
Inputs: status_id (required). Returns: result
wetrack_delete_widgetA
Delete a report widget from the current user's dashboard.
Args: widget_id: Widget ID from wetrack_list_widgets.
Inputs: widget_id (required). Returns: result
wetrack_exit_impersonationA
Exit the current impersonation session and restore the administrator session. Only works if you previously called wetrack_impersonate.
Inputs: no named parameters. Returns: result
wetrack_forgot_passwordA
Trigger a password reset email for a user.
Args: email: The email address of the user who forgot their password.
Inputs: email (required). Returns: result
wetrack_get_clientC
Get details of a specific client organisation.
Args: client_id: The client/organisation ID.
Inputs: client_id (required). Returns: result
wetrack_get_current_userA
Get the currently authenticated user's profile and sidebar permissions. Useful to verify who is logged in and what their role is.
Inputs: no named parameters. Returns: result
wetrack_get_dashboardA
Get the aggregated dashboard ā KPIs, Team Workload, Status Donut, Project Health, Pending Tickets, and Sprint Burndown.
Args: project_id: Scope dashboard to a specific project UUID. sprint_id: Specify a sprint UUID for the burndown chart.
Inputs: sprint_id, project_id. Returns: result
wetrack_get_metadata_fieldA
Get a single metadata field definition by ID.
Args: field_id: Integer ID of the metadata field.
Inputs: field_id (required). Returns: result
wetrack_get_microsoft_signin_urlA
Get the Microsoft OAuth sign-in URL to start the login flow.
Returns a URL that the user must open in a browser to complete Microsoft/Azure AD authentication. After login, WeTrack will set a session cookie and redirect to the configured success URL.
Workflow:
Call this tool to get the Microsoft OAuth URL.
Open the URL in your browser.
Complete Microsoft login.
Copy the JWT token from the WeTrack response/cookie.
Call wetrack_set_token with the token to use it here.
Note: Microsoft OAuth requires browser interaction and cannot be automated fully through MCP. Use email/password sign-in for non-SSO accounts via wetrack_sign_in.
Inputs: no named parameters. Returns: result
wetrack_get_my_sprint_reportA
Current user's My Sprint report ā progress, burndown, distributions, and ticket list for the sprint the current user is part of.
Args: sprint_id: Sprint UUID (defaults to the user's current active sprint). status_id: Filter by status ID. priority_id: Filter by priority ID. page: Page number. limit: Items per page.
Inputs: page, limit, sprint_id, status_id, +1 more. Returns: result
wetrack_get_my_work_reportB
Current user's My Work report ā stat cards, status/priority distributions, and a ticket list scoped to what's assigned to me.
Args: project_id: Filter by project UUID. status_id: Filter by status ID. priority_id: Filter by priority ID. date_range: 'this_week', 'this_month', 'this_sprint', or 'custom'. from_date: Start of custom date range (YYYY-MM-DD). to_date: End of custom date range (YYYY-MM-DD). page: Page number. limit: Items per page.
Inputs: page, limit, to_date, from_date, +4 more. Returns: result
wetrack_get_oauth_callback_infoA
Get information about the Microsoft OAuth callback endpoint. This endpoint is called automatically by Microsoft after login ā it resolves the identity to a WeTrack user (auto-registering on first login) and issues a session.
Returns documentation about the callback flow rather than calling the endpoint (which requires browser-level interaction with state params).
Inputs: no named parameters. Returns: result
wetrack_get_projectC
Get full details of a single project.
Args: project_id: The project UUID.
Inputs: project_id (required). Returns: result
wetrack_get_project_overviewA
Get the complete overview dashboard analytics for a project ā includes KPIs, ticket distributions, team stats, and progress.
Args: project_id: The project UUID.
Inputs: project_id (required). Returns: result
wetrack_get_project_reportsC
Get comprehensive reports and analytics for a project.
Args: project_id: The project UUID. sprint_id: Optional sprint UUID to scope stats to a specific sprint.
Inputs: project_id (required), sprint_id. Returns: result
wetrack_get_project_sprintsA
Get all sprints for a project including statistics and progress metrics.
Args: project_id: The project UUID.
Inputs: project_id (required). Returns: result
wetrack_get_project_statsA
Get dashboard statistics ā summary totals, top projects by progress, and upcoming project deadlines.
Args: top_limit: Number of top projects to return (default: 5). deadlines_limit: Number of upcoming deadlines to return (default: 3).
Inputs: top_limit, deadlines_limit. Returns: result
wetrack_get_project_usersA
Get all team members mapped to a project (derived from ticket assignees). Returns {id, name, email, role, designation} per user.
Args: project_id: The project UUID.
Inputs: project_id (required). Returns: result
wetrack_get_recent_projectsA
Get the most recently accessed projects for the authenticated user.
Args: limit: Max projects to return (1-10, default: 4).
Inputs: limit. Returns: result
wetrack_get_reportsA
Unified Reports Dashboard ā scoped dynamically for Admin/Manager/Employee. Includes stat cards, status/priority distributions, project progress, sprint burndown, and summary table.
Args: project_id: Filter by project UUID. sprint_id: Filter by sprint UUID. status_id: Filter by ticket status ID. priority_id: Filter by ticket priority ID. user_id: Scope to tickets assigned to this user UUID. burndown_range: Burndown scope ā 'this_month', 'this_week', 'last_30_days', 'custom'. burndown_from: Start date for custom burndown range (YYYY-MM-DD). burndown_to: End date for custom burndown range (YYYY-MM-DD). page: Page number (default: 1). limit: Rows per page (default: 10).
Inputs: page, limit, user_id, sprint_id, +6 more. Returns: result
wetrack_get_reports_catalogA
List every report available to the current user's role. Shows dataSource type ('existing', 'generic', 'custom') and default metric/dimension/chartType to use when creating a widget.
Inputs: no named parameters. Returns: result
wetrack_get_sprintA
Get full details of a single sprint.
Args: sprint_id: The sprint UUID.
Inputs: sprint_id (required). Returns: result
wetrack_get_ticketA
Get full details of a single ticket by its ID. Returns different shapes for work items (EPIC/STORY/TASK/BUG) vs support tickets.
Args: ticket_id: The ticket UUID or numeric ID.
Inputs: ticket_id (required). Returns: result
wetrack_get_ticket_attachmentsB
List all file attachments on a ticket.
Args: ticket_id: The ticket UUID.
Inputs: ticket_id (required). Returns: result
wetrack_get_ticket_categoryB
Get a single ticket category by ID.
Args: category_id: The category ID.
Inputs: category_id (required). Returns: result
wetrack_get_ticket_commentsA
Get all comments on a ticket, in chronological order.
Args: ticket_id: The ticket UUID.
Inputs: ticket_id (required). Returns: result
wetrack_get_ticket_historyA
Get the full audit history/changelog for a ticket. Shows every field change with who made it and when.
Args: ticket_id: The ticket UUID.
Inputs: ticket_id (required). Returns: result
wetrack_get_ticket_priorityB
Get a single ticket priority by ID.
Args: priority_id: The priority ID.
Inputs: priority_id (required). Returns: result
wetrack_get_ticket_productB
Get a single ticket product by ID.
Args: product_id: The product ID.
Inputs: product_id (required). Returns: result
wetrack_get_ticket_statusA
Get a single ticket status by ID.
Args: status_id: The status ID.
Inputs: status_id (required). Returns: result
wetrack_get_ticket_typeA
Get a single ticket type by ID.
Args: type_id: The ticket type ID.
Inputs: type_id (required). Returns: result
wetrack_get_ticket_watchersA
Get the watch/follow status and list of watchers for a ticket.
Args: ticket_id: The ticket UUID.
Inputs: ticket_id (required). Returns: result
wetrack_get_unread_notification_countA
Get the total number of unread notifications for the authenticated user. Useful for showing a badge count.
Inputs: no named parameters. Returns: result
wetrack_get_upload_instructionsA
Get instructions on how to upload files to WeTrack via S3.
Since MCP cannot directly stream binary files, this tool explains the complete upload workflow so you can guide the user correctly.
Inputs: no named parameters. Returns: result
wetrack_get_upload_presign_urlA
Generate an S3 pre-signed upload URL for direct browser-side file uploads.
This is step 1 of the two-step upload flow:
Call this to get a presigned PUT URL and the final S3 file URL.
The client/browser PUTs the file binary directly to the presigned URL.
Use the final S3 URL in wetrack_add_ticket_attachment or wetrack_add_project_file to register the file in WeTrack.
Args: file_name: Original file name e.g. 'screenshot.png', 'report.pdf'. file_type: MIME type e.g. 'image/png', 'application/pdf', 'video/mp4'.
Returns: presignedUrl: The S3 PUT URL to upload the file to (expires in ~15 min). url: The final public S3 URL to use as the attachment URL in WeTrack.
Inputs: file_name (required), file_type (required). Returns: result
wetrack_get_userB
Get a single user's details by their ID.
Args: user_id: The user UUID or integer ID.
Inputs: user_id (required). Returns: result
wetrack_get_webhook_infoA
Get information about the WeTrack inbound email webhook endpoint. This endpoint is called by Resend (or any Svix-compatible provider) when an inbound email is received and creates a ticket automatically.
Returns documentation about the webhook setup rather than calling the endpoint (which requires Svix signature headers from the provider).
Inputs: no named parameters. Returns: result
wetrack_get_widget_dataA
Run a widget's metric+dimension query and return chart-ready data. Returns label/value pairs (one per group, up to 50 groups).
Args: widget_id: Widget ID from wetrack_list_widgets or wetrack_create_widget.
Inputs: widget_id (required). Returns: result
wetrack_impersonateA
[Admin only] Start an impersonation session ā log in AS another user. Use wetrack_exit_impersonation to restore the admin session.
Args: target_user_id: UUID of the user to impersonate.
Inputs: target_user_id (required). Returns: result
wetrack_list_clientsA
Retrieve list of all client organisations accessible by the current user.
Inputs: no named parameters. Returns: result
wetrack_list_metadata_fieldsB
Get all custom metadata field definitions.
Args: resource_type: Filter by resource ā 'TICKET', 'PROJECT', or 'SPRINT'. ticket_type: Filter by ticket type ā 'EPIC', 'STORY', 'TASK', 'BUG'. Only meaningful when resource_type is 'TICKET'. is_active: Filter by active status. page: Page number (default: 1). limit: Items per page (default: 10).
Inputs: page, limit, is_active, ticket_type, +1 more. Returns: result
wetrack_list_notificationsA
Retrieve paginated notifications for the authenticated user.
Args: status: Filter by read status ā 'all' (default), 'unread', or 'read'. category: Filter by type ā 'all' (default), 'comment', or 'update'. project_id: Filter notifications to a specific project UUID. page: Page number (default: 1). limit: Items per page, max 100 (default: 20).
Inputs: page, limit, status, category, +1 more. Returns: result
wetrack_list_organisationsA
Retrieve the list of all organisations in the system.
Inputs: no named parameters. Returns: result
wetrack_list_project_filesA
Get all files, folders, and ticket attachments for a project with storage stats.
Args: project_id: The project UUID. folder_id: Filter to a specific folder UUID (pass 'root' or omit for root level). search: Search files/folders by name.
Inputs: project_id (required), search, folder_id. Returns: result
wetrack_list_projectsA
List projects with filtering, search, and pagination.
Args: minimal: If True, returns lightweight {id, name} list for dropdowns. search: Search by name, key, description, or manager name. status: Filter by status ā 'NOT_STARTED', 'IN_PROGRESS', 'COMPLETED', 'ON_HOLD'. start_date: Filter projects starting on/after this date (YYYY-MM-DD). end_date: Filter projects ending on/before this date (YYYY-MM-DD). sort: Sort field ā 'name', 'key', 'status', 'start_date', 'end_date', 'created_at'. order: Sort direction ā 'asc' or 'desc'. page: Page number (default: 1). limit: Items per page (default: 10).
Inputs: page, sort, limit, order, +5 more. Returns: result
wetrack_list_sprintsA
List sprints across all projects or scoped to one project.
Args: project_id: Filter to a single project's sprints (UUID). search: Case-insensitive substring match against sprint name. status: Comma-separated sprint statuses ā 'PLANNED', 'IN_PROGRESS', 'COMPLETED'. include_completed: Pass False to exclude completed sprints. page: Page number (default: 1). limit: Items per page (default: 10).
Inputs: page, limit, search, status, +2 more. Returns: result
wetrack_list_ticket_categoriesB
Get all ticket categories.
Inputs: no named parameters. Returns: result
wetrack_list_ticket_prioritiesA
Get the list of ticket priorities.
Args: resource: Filter by resource ā 'SPRINT', 'TASK', or 'PROJECT'. include_inactive: Include soft-deleted priorities (default: False).
Inputs: resource, include_inactive. Returns: result
wetrack_list_ticket_productsB
Get all ticket products.
Inputs: no named parameters. Returns: result
wetrack_list_ticketsA
List and filter tickets (work items and support tickets).
Args: project_id: Filter by project UUID. Comma-separated for multiple. ticket_type: Filter by type ā EPIC, STORY, TASK, BUG (comma-separated). sprint_id: Sprint UUID. Pass 'null' or 'unassigned' for backlog. status_id: Status ID(s), comma-separated. priority_id: Priority ID(s), comma-separated. search: Case-insensitive search against title or summary. assigned_to_me: If true, only show tickets assigned to me. is_backlog: If true, only show backlog tickets (no sprint assigned). is_active_sprint: If true, only show tickets in the active sprint. due_date: Filter bucket ā 'Overdue', 'Due Today', 'Due This Week', 'Due This Month', 'No Due Date'. sort_order: 'asc' or 'desc' (default: desc = newest first). view: Response shape ā 'default' (full), 'card' (board), 'summary' (dropdown). page: Page number (default: 1). limit: Rows per page, max 100 (default: 20).
Inputs: page, view, limit, search, +10 more. Returns: result
wetrack_list_ticket_statusesA
Get the list of ticket statuses.
Args: resource: Filter by resource ā 'SPRINT', 'TASK', or 'PROJECT'. Omit to return all statuses. include_inactive: Include soft-deleted statuses (default: False).
Inputs: resource, include_inactive. Returns: result
wetrack_list_ticket_typesA
Get all ticket types.
Inputs: no named parameters. Returns: result
wetrack_list_timezonesA
Get all available timezones. Use the returned integer IDs when creating clients or organisations that need a specific timezone.
Inputs: no named parameters. Returns: result
wetrack_list_usersA
Retrieve the list of users in the organisation.
Args: role: Filter by role ā 'ADMIN', 'VITHI_USER', 'EMPLOYEE', 'CUSTOMER'. is_dropdown: If True, returns lightweight {id, name} for dropdowns. If False/omitted, returns full user details including designation.
Inputs: role, is_dropdown. Returns: result
wetrack_list_widgetsA
List the current user's report widgets in display order. Each widget has an id, metric, dimension, chartType, isVisible, and orderIndex.
Inputs: no named parameters. Returns: result
wetrack_mark_all_notifications_readA
Mark ALL notifications as read for the authenticated user at once.
Inputs: no named parameters. Returns: result
wetrack_mark_notification_readA
Mark a single notification as read.
Args: notification_id: Notification ID e.g. 'hist_123' or 'comm_456'.
Inputs: notification_id (required). Returns: result
wetrack_record_project_accessA
Record that the current user accessed a project (updates 'recently accessed' list).
Args: project_id: The project UUID.
Inputs: project_id (required). Returns: result
wetrack_reorder_widgetsA
Persist the display order of the current user's report widgets.
Args: ordered_ids: ALL widget IDs in the desired top-to-bottom order (not just the one that moved). Get current IDs from wetrack_list_widgets first.
Example: ["widget-id-1", "widget-id-2", "widget-id-3"]
Inputs: ordered_ids (required). Returns: result
wetrack_resend_inviteB
Resend the invitation email to a user who hasn't set their password yet.
Args: user_id: The user UUID or integer ID.
Inputs: user_id (required). Returns: result
wetrack_searchA
Global search across WeTrack ā tickets, projects, sprints, and users with weighted relevance ranking.
Args: query: Search keyword or ticket code e.g. 'MOB-1', 'authentication', 'login bug'. search_type: Scope ā 'all' (default), 'tickets', 'projects', 'sprints', or 'users'. project_id: Scope search to a specific project UUID. limit: Max results per category (1-20, default: 6).
Inputs: query (required), limit, project_id, search_type. Returns: result
wetrack_set_passwordA
Set the initial password for the currently authenticated user (used during first-time login flows).
Args: password: The new password to set.
Inputs: password (required). Returns: result
wetrack_set_tokenA
Manually set a JWT token for all subsequent WeTrack API calls. Use this after completing Microsoft OAuth login in a browser to store your token in the MCP server session.
Args: token: The JWT Bearer token string from your WeTrack session.
After setting this, all tool calls will use Bearer automatically. The token is stored in-memory for this session only.
Inputs: token (required). Returns: result
wetrack_sign_inA
Sign in to WeTrack with email and password. Returns a JWT token stored for all future requests. Use this first if you haven't set WETRACK_EMAIL/PASSWORD in .env.
Inputs: email (required), password (required). Returns: result
wetrack_sign_outA
Sign out from WeTrack and clear the current session token.
Inputs: no named parameters. Returns: result
wetrack_toggle_metadata_field_statusB
Toggle a metadata field's active/inactive status.
Args: field_id: Integer ID of the metadata field.
Inputs: field_id (required). Returns: result
wetrack_toggle_ticket_productB
Toggle the active/inactive status of a ticket product.
Args: product_id: The product ID.
Inputs: product_id (required). Returns: result
wetrack_toggle_ticket_watchA
Toggle your watch/follow status on a ticket. If you're not watching, this starts watching. If you are, it stops.
Args: ticket_id: The ticket UUID.
Inputs: ticket_id (required). Returns: result
wetrack_trigger_sla_checkA
[System/Admin] Trigger the SLA breach notification check. Normally called by an automated scheduler ā this tool lets you trigger it manually for testing or on-demand checks.
Args: breach_count: Number of SLA breaches to process e.g. 3. auth_key: System auth key (WETRACK_AUTH_KEY from .env). If not provided, reads from WETRACK_AUTH_KEY env var.
Note: This requires the WETRACK_AUTH_KEY environment variable to be set, not the regular user JWT. Contact your WeTrack admin for this key.
Inputs: breach_count (required), auth_key. Returns: result
wetrack_trigger_sprint_burndown_snapshotA
[System/Admin] Snapshot today's remaining scope for every active sprint. Normally called by an automated daily scheduler ā this tool lets you trigger it manually for testing or to backfill a missed snapshot.
Args: auth_key: System auth key (WETRACK_AUTH_KEY from .env). If not provided, reads from WETRACK_AUTH_KEY env var.
Note: This requires the WETRACK_AUTH_KEY, not the regular user JWT.
Inputs: auth_key. Returns: result
wetrack_update_clientB
Update a client organisation's details.
Args: client_id: The client ID. name: Organisation name (required). email: Primary email (required). phone: Phone number. contact_name: Primary contact person name. contact_email: Contact email. contact_phone: Contact phone. address: Physical address. country: Country name. timezone_id: Timezone integer ID.
Inputs: name (required), email (required), client_id (required), phone, +6 more. Returns: result
wetrack_update_metadata_fieldC
Update an existing metadata field definition.
Args: field_id: Integer ID of the metadata field. label: New field label (required). helper_text: New helper text. is_required: New required state. options: New options list for SELECT/MULTI_SELECT fields: [{"label": "...", "value": "..."}, ...]
Inputs: label (required), field_id (required), options, helper_text, +1 more. Returns: result
wetrack_update_projectA
Update a project's fields (partial update ā only send what changes). Changing timeline recalculates sprints automatically.
Args: project_id: The project UUID. name: New project name. manager_id: UUID of new project manager. description: New description. start_date: New start date 'YYYY-MM-DD'. end_date: New end date 'YYYY-MM-DD'. sprint_duration_weeks: New sprint duration in weeks. color: New hex color. tags: New tag list (replaces existing).
Inputs: project_id (required), name, tags, color, +5 more. Returns: result
wetrack_update_sprintA
Update sprint details, status, or goal.
Args: sprint_id: The sprint UUID. name: New sprint name. start_date: New start date 'YYYY-MM-DD'. end_date: New end date 'YYYY-MM-DD'. goal: New sprint goal text. status: New status ā 'PLANNED', 'IN_PROGRESS', or 'COMPLETED'. move_to: Where to move unfinished tickets when completing a sprint. Use 'BACKLOG' or a target sprint UUID.
Inputs: sprint_id (required), goal, name, status, +3 more. Returns: result
wetrack_update_ticketA
Update a ticket's fields. Only fields you provide are changed.
Args: ticket_id: UUID of the ticket to update. title: New title. description: New rich HTML description. request_status_id: New status ID. request_priority_id: New priority ID. assignees: New list of assignee user UUIDs (replaces all existing assignees). summary: New short summary. story_points: New story points (positive integer). bug_type: New bug category. tags: New tag list (replaces existing). end_date: New due date (ISO datetime). parent_id: Reassign to a different parent EPIC. sprint_id: Move to a different sprint UUID.
Inputs: ticket_id (required), tags, title, summary, +9 more. Returns: result
wetrack_update_ticket_categoryC
Update a ticket category.
Args: category_id: The category ID. name: Category name (required). description: Optional description. color: Hex color. icon: Icon identifier. is_active: Active state.
Inputs: name (required), category_id (required), icon, color, +2 more. Returns: result
wetrack_update_ticket_priorityA
Update a ticket priority by ID.
Args: priority_id: The priority ID. name: New priority name (required ā code is auto-derived from it). priority_type: Severity bucket ā 'LOW', 'MEDIUM', 'HIGH', 'CRITICAL'. resource: Resource type ā 'SPRINT', 'TASK', 'PROJECT'. description: Optional description. color: Hex color. icon: Icon identifier.
Inputs: name (required), priority_id (required), icon, color, +3 more. Returns: result
wetrack_update_ticket_productB
Update a ticket product.
Args: product_id: The product ID. name: New name (required). description: New description. is_active: Active state.
Inputs: name (required), product_id (required), is_active, description. Returns: result
wetrack_update_ticket_statusA
Update a ticket status. Name, category, and resource are all required on update.
Args: status_id: The status ID. name: Status name. category: 'TO_DO', 'IN_PROGRESS', or 'DONE'. resource: 'SPRINT', 'TASK', or 'PROJECT'. description: Optional description. color: Hex color. icon: Icon identifier. pauses_sla: Whether this status pauses SLA timer.
Inputs: name (required), category (required), resource (required), status_id (required), +4 more. Returns: result
wetrack_update_ticket_typeA
Update a ticket type.
Args: type_id: The ticket type ID. name: New name (required). description: New description. color: New hex color. icon: New icon identifier.
Inputs: name (required), type_id (required), icon, color, +1 more. Returns: result
wetrack_update_userC
Update a user's profile fields.
Args: user_id: The user UUID or integer ID. first_name: New first name. last_name: New last name. role: New role ā 'ADMIN', 'VITHI_USER', 'EMPLOYEE', 'CUSTOMER'. designation: New job title. Cannot be an empty string.
Inputs: user_id (required), role, last_name, first_name, +1 more. Returns: result
wetrack_update_widgetA
Update a report widget. At least one field must be provided.
Args: widget_id: Widget ID from wetrack_list_widgets. title: New display title (non-empty if provided). metric: New metric ā see wetrack_create_widget for valid values. dimension: New dimension ā see wetrack_create_widget for valid values. chart_type: Switch chart type ā 'BAR', 'LINE', 'PIE', 'DONUT', 'TABLE', 'AREA'. is_visible: Show/hide the widget (True = show, False = hide).
Inputs: widget_id (required), title, metric, dimension, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 110 tools
Multiple reporting/dashboard tools (wetrack_get_reports, wetrack_get_dashboard, wetrack_get_project_reports, wetrack_get_project_overview, wetrack_get_project_stats) have heavily overlapping purposes and outputs, making misselection likely. The client vs organisation tools are also ambiguous since both describe similar organisation entities with nearly identical fields.
Most tools follow a consistent wetrack_verb_noun snake_case pattern, which makes the set readable and predictable. There are minor deviations such as add_ vs create_ verbs, sign_in vs the signin_url naming, and the similar list_organisations/list_clients pair, but the overall convention remains strong.
At 110 tools, the surface is far beyond a manageable MCP tool set and creates a severe agent selection burden. Even though the domain is broad, many tools are niche admin, reporting, and system-trigger utilities that should be consolidated or exposed through fewer composite tools.
The tool surface is broad and covers most core lifecycle operations for projects, tickets, sprints, users, configurations, files, notifications, and reports. Notable gaps include no ticket deletion, no user deactivation/deletion, and no client/organisation removal, but these are workable gaps rather than fundamental dead ends.
Maintenance
Related MCP Connectors
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Project tracker for AI agents and teams: file, claim, update and hand off tickets over MCP.
Manage Loom projects, tasks, bugs, defects, clients and phases from AI assistants
Manage projects, tasks, time tracking, and team collaboration through natural language.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Yandex.Tracker task management system through MCP protocol. Supports creating and managing issues, searching tasks, handling comments, managing projects and queues, and generating analytics reports.ISC
- FlicenseNot gradedqualityDmaintenanceEnables LLM agents to manage projects, track issues, log work, and integrate with Git. Provides 23 MCP tools for full project management capabilities.15-
- FlicenseBqualityDmaintenanceMCP server that exposes the V-Track project management API as tools for AI assistants, enabling interaction with projects, tasks, issues, sprints, and more.54-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with JetBrains YouTrack for issue, project, and user management through natural language.1-