Skip to main content
Glama

VTrack MCP Server

MCP (Model Context Protocol) server that exposes the V-Track project management API as tools for AI assistants.

Setup

1. Install dependencies

npm install

2. Build

npm run build

3. Configure

Set environment variables before starting:

Variable

Description

Default

VTRACK_BASE_URL

V-Track API base URL

http://localhost:3000

VTRACK_ACCESS_TOKEN

Bearer access token

(empty)

Or call the configure tool at runtime to set them dynamically.

4. Run

npm start
# or for development
npm run dev

Related MCP server: taiga-mcp

Connecting to Claude Desktop / Claude Code

Add to your MCP config (e.g. ~/.claude/settings.json or Claude Desktop config):

{
  "mcpServers": {
    "vtrack": {
      "command": "node",
      "args": ["D:/workspace/vtrack-mcp/dist/index.js"],
      "env": {
        "VTRACK_BASE_URL": "https://your-vtrack-api.example.com",
        "VTRACK_ACCESS_TOKEN": "your-bearer-token"
      }
    }
  }
}

Available Tools

Meta

Tool

Description

configure

Set base URL and access token at runtime

Auth

Tool

Description

auth_login

Login, returns accessToken + refreshToken

auth_refresh

Refresh access token

auth_logout

Logout current user

Users

Tool

Description

users_list

Paginated user list

users_me

Current user info

users_detail

User detail by ID

Projects

Tool

Description

projects_list

Paginated project list

projects_detail

Project detail by ID

projects_export_members_excel

Export members as Excel

Tasks

Tool

Description

tasks_list

Paginated task list with filters

tasks_detail

Task detail by ID

tasks_kanban_board

Kanban board grouped by status

Backlog

Tool

Description

backlog_list

Paginated backlog (feature tasks)

backlog_detail

Backlog item detail

Issues

Tool

Description

issues_list

Paginated issues (bug tasks)

issues_detail

Issue detail by ID

Sprints

Tool

Description

sprints_list

Paginated sprint list

sprints_list_active

Active sprints only

sprints_detail

Sprint detail by ID

sprints_list_for_filter

Lightweight sprint list for dropdowns

Project Members

Tool

Description

project_members_list

Members of a project

Task Comments

Tool

Description

task_comments_list

Comments for a task (cursor-based)

task_comments_detail

Comment detail by ID

Attachments

Tool

Description

attachments_list

Attachments for an entity

attachments_detail

Attachment detail by ID

Requests

Tool

Description

requests_list

Paginated request list

requests_detail

Request detail by ID

Milestones

Tool

Description

milestones_list

Paginated milestone list

milestones_detail

Milestone detail by ID

Reports

Tool

Description

reports_global

System-wide metrics

reports_attention

System-wide alerts

reports_project

Project-level report

reports_export_data

Exportable project data

reports_project_attention

Project-level alerts

Workload

Tool

Description

workload_list

Workload per team member

Lookup Tables

Tool

Description

lookup_priorities

All priorities

lookup_roles

All system roles

lookup_project_roles

All project roles

lookup_task_types

Task types (optionally by project)

lookup_request_types

Request types (optionally by project)

lookup_request_channels

Request channels

lookup_statuses

All statuses (no auth required)

Notifications

Tool

Description

notifications_list

User's notifications

notifications_mark_read

Mark one notification as read

notifications_mark_all_read

Mark all notifications as read

Meeting Notes

Tool

Description

meeting_notes_list

Paginated meeting notes

meeting_notes_detail

Meeting note detail by ID

Service Monitors

Tool

Description

service_monitors_list

Paginated monitor list

service_monitors_detail

Monitor detail

service_monitors_logs

Monitor logs

service_monitors_incidents

Incident list

service_monitors_incident_detail

Incident detail

service_monitors_sla_stats

SLA statistics

service_monitors_uptime_stats

Uptime statistics

Misc

Tool

Description

health_check

API health check

audit_logs

Paginated audit logs


Response Format

All V-Track responses follow this envelope:

{
  "code": 0,
  "message": "...",
  "data": {},
  "total": 100,
  "totalPages": 10
}

code: 0 = success. Errors: -2 bad request, -3 unauthorized, -4 not found.

Available Tools

54 tools
attachments_detailB

Get detailed information about a specific attachment.

Inputs: id (required).

attachments_listA

Get list of attachments for a given entity (task, project, etc.).

Inputs: entityType (required), entityId (required).

audit_logsC

Get audit logs, optionally filtered by user.

Inputs: userId, page, pageSize, filters.

backlog_detailC

Get detailed information about a specific backlog item.

Inputs: id (required).

backlog_listB

Get paginated list of backlog items (feature tasks without sprint).

Inputs: page, pageSize, filters, projectId, +8 more.

configureA

Configure the MCP server connection (base URL and access token). Call this before using other tools if environment variables are not set.

Inputs: baseUrl, accessToken.

health_checkA

Check if the V-Track API is healthy and reachable.

Inputs: no named parameters.

issues_detailB

Get detailed information about a specific issue.

Inputs: id (required).

issues_listB

Get paginated list of issues (bug tasks without sprint).

Inputs: page, pageSize, filters, projectId, +8 more.

lookup_prioritiesA

Get all available task/request priorities.

Inputs: no named parameters.

lookup_project_rolesA

Get all available project roles.

Inputs: no named parameters.

lookup_request_channelsA

Get all available request channels.

Inputs: no named parameters.

lookup_request_typesC

Get request types, optionally filtered by project.

Inputs: projectId.

lookup_rolesA

Get all available system roles.

Inputs: no named parameters.

lookup_statusesA

Get all available statuses (no auth required).

Inputs: no named parameters.

lookup_task_typesC

Get task types, optionally filtered by project.

Inputs: projectId.

meeting_notes_detailB

Get detailed information about a specific meeting note.

Inputs: id (required).

meeting_notes_listC

Get paginated list of meeting notes for a project.

Inputs: page, pageSize, filters, projectId.

milestones_detailB

Get detailed information about a specific milestone.

Inputs: id (required).

milestones_listC

Get paginated list of milestones for a project.

Inputs: page, pageSize, filters, projectId, +1 more.

notifications_listA

Get notifications for the currently authenticated user.

Inputs: no named parameters.

notifications_mark_all_readA

Mark all notifications as read for the current user.

Inputs: no named parameters.

notifications_mark_readA

Mark a specific notification as read.

Inputs: id (required).

project_members_listC

Get paginated list of members for a project.

Inputs: page, pageSize, filters, projectId.

projects_detailB

Get detailed information about a specific project.

Inputs: id (required).

projects_export_members_excelC

Export project members list as an Excel file.

Inputs: no named parameters.

projects_listC

Get paginated list of projects with optional filters.

Inputs: page, pageSize, filters, statusId, +1 more.

reports_attentionB

Get system-wide alerts and items needing attention.

Inputs: no named parameters.

reports_export_dataC

Get exportable report data for a project.

Inputs: projectId (required), startDate (required), endDate (required), sprintId.

reports_globalA

Get global system-wide metrics and KPIs.

Inputs: no named parameters.

reports_projectC

Get report metrics for a specific project.

Inputs: projectId (required), sprintId, startDate, endDate.

reports_project_attentionC

Get alerts and items needing attention for a specific project.

Inputs: projectId (required), sprintId, startDate, endDate.

requests_detailC

Get detailed information about a specific request.

Inputs: id (required).

requests_listC

Get paginated list of requests with optional filters.

Inputs: page, pageSize, filters, projectId, +7 more.

service_monitors_detailB

Get detailed information about a specific service monitor.

Inputs: id (required).

service_monitors_incident_detailB

Get detailed information about a specific incident.

Inputs: id (required).

service_monitors_incidentsC

Get paginated list of incidents.

Inputs: page, pageSize, filters.

service_monitors_listC

Get paginated list of service monitors.

Inputs: page, pageSize, filters.

service_monitors_logsC

Get paginated monitor logs.

Inputs: page, pageSize, filters.

service_monitors_sla_statsC

Get SLA statistics for a service monitor.

Inputs: monitorId (required), startDate, endDate.

service_monitors_uptime_statsC

Get uptime statistics for a service monitor.

Inputs: monitorId (required), startDate, endDate.

sprints_detailB

Get detailed information about a specific sprint.

Inputs: id (required).

sprints_listC

Get paginated list of sprints for a project.

Inputs: page, pageSize, filters, projectId.

sprints_list_activeB

Get paginated list of active sprints for a project.

Inputs: page, pageSize, filters, projectId.

sprints_list_for_filterC

Get sprint list for use in filter dropdowns (lightweight).

Inputs: projectId.

task_comments_detailA

Get detailed information about a specific task comment.

Inputs: id (required).

task_comments_listB

Get comments for a task in chat style (cursor-based pagination).

Inputs: taskId (required), limit, cursor.

tasks_detailB

Get detailed information about a specific task.

Inputs: id (required).

tasks_kanban_boardA

Get the Kanban board view of tasks grouped by status for a project/sprint.

Inputs: projectId (required), sprintId, viewAll.

tasks_listC

Get paginated list of tasks with optional filters.

Inputs: page, pageSize, filters, projectId, +5 more.

users_detailB

Get detailed information about a specific user by ID.

Inputs: id (required).

users_listB

Get paginated list of users with optional filters.

Inputs: page, pageSize, filters.

users_meA

Get information about the currently authenticated user.

Inputs: no named parameters.

workload_listC

Get workload data per team member for a project.

Inputs: projectId (required), startDate, endDate, memberName, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 54 tools

    Disambiguation4/5

    Most tools target distinct resources or actions due to descriptive names, but there is minor overlap between backlog_list, issues_list, and tasks_list (all task-like concepts) and among sprints-related tools. Descriptions help differentiate them.

    Naming Consistency5/5

    All tool names follow a consistent resource_action pattern with underscores (e.g., attachments_list, projects_detail). No mixing of conventions or ambiguous verbs.

    Tool Count3/5

    54 tools is high for a typical MCP server, but the domain (project management) is broad and each tool targets a specific aspect (CRUD per resource). The count is justifiable but borderline excessive.

    Completeness2/5

    The surface heavily favors read operations (list, detail) with no create/update/delete tools except notifications_mark_read. This leaves significant gaps for an agent needing to modify resources, limiting workflow completeness.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Yandex Tracker API, enabling AI assistants to search, read, create, and edit issues, as well as manage comments, attachments, and links in Yandex Tracker.
      63 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for the Taiga project management API. Enables AI assistants to manage projects, issues, user stories, tasks, epics, sprints, and wiki pages via natural language commands.
      55
      9 npm
      ISC
    • F
      license
      C
      quality
      D
      maintenance
      MCP server for the Zube.io project management API, exposing boards, cards, epics, tickets, sprints, and workspaces as tools for AI assistants.
      42
      -