MCP Tools Reference
Detailed parameter documentation for all 46 MCP tools.
Issue Tracking
list_issues
List issues in the workspace with optional filters.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | No | Filter by project ID |
statusId | string | No | Filter by status ID |
priority | string | No | Filter by priority: URGENT, HIGH, MEDIUM, LOW, NONE |
assigneeId | string | No | Filter by assignee user ID |
labelId | string | No | Filter by label ID |
limit | number | No | Max results (default 50, max 50) |
offset | number | No | Offset for pagination |
get_issue
Get full details of a specific issue including labels.
| Parameter | Type | Required | Description |
|---|---|---|---|
issueId | string | Yes | Issue UUID or identifier (e.g., "ENG-123") |
create_issue
Create a new issue in the workspace. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Issue title |
description | string | No | Issue description (plain text, Markdown, or HTML). Markdown is automatically rendered as rich text in the UI. |
teamId | string | Yes | Team ID to create the issue in |
projectId | string | No | Project ID to assign to |
priority | string | No | Priority: URGENT, HIGH, MEDIUM, LOW, NONE |
statusId | string | No | Status ID (defaults to team's default status) |
assigneeId | string | No | User ID to assign |
labelIds | string[] | No | Label IDs to attach |
update_issue
Update an existing issue. Only provided fields are changed. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
issueId | string | Yes | Issue UUID to update |
title | string | No | New title |
description | string | No | New description (plain text, Markdown, or HTML). Markdown is automatically rendered as rich text in the UI. |
priority | string | No | New priority |
statusId | string | No | New status ID |
assigneeId | string | No | New assignee (null to unassign) |
search_issues
Full-text search across issue titles, descriptions, and identifiers.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query string |
limit | number | No | Max results (default 20, max 50) |
add_comment
Add a comment to an issue. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
issueId | string | Yes | Issue UUID to comment on |
body | string | Yes | Comment text (plain text or markdown) |
parentId | string | No | Parent comment ID for threaded replies |
list_comments
List all comments on an issue, ordered by creation date.
| Parameter | Type | Required | Description |
|---|---|---|---|
issueId | string | Yes | Issue UUID |
Projects & Cycles
list_projects
List all projects in the workspace with optional status filter.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status: BACKLOG, PLANNED, IN_PROGRESS, COMPLETED, CANCELLED |
get_project
Get detailed information about a project including milestones and issue count.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project UUID |
list_cycles
List sprint cycles for teams in the workspace.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status: UPCOMING, ACTIVE, COMPLETED |
get_cycle
Get a single cycle with issue counts and completion progress.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Cycle UUID |
Workspace Metadata
list_teams, list_labels, list_statuses, list_members
These tools list workspace metadata. They take no parameters and return arrays of the respective entities with their IDs and names. Use these to resolve IDs before calling other tools.
Roadmap
list_roadmap_items
List roadmap items in the workspace with optional filters.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status: PLANNED, IN_PROGRESS, COMPLETED, CANCELLED |
category | string | No | Filter by category: FEATURE, IMPROVEMENT, BUG, INFRASTRUCTURE |
versionId | string | No | Filter by roadmap version ID |
limit | number | No | Max results (default 50, max 100) |
create_roadmap_item
Create a new roadmap item. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Item title |
description | string | No | Item description |
status | string | No | Status: PLANNED (default), IN_PROGRESS, COMPLETED, CANCELLED |
category | string | No | Category: FEATURE (default), IMPROVEMENT, BUG, INFRASTRUCTURE |
versionId | string | No | Assign to a roadmap version |
assigneeId | string | No | Assign to a user |
isPublic | string | No | Whether publicly visible ("true"/"false", default "true") |
update_roadmap_item
Update an existing roadmap item. Only provided fields are changed. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Roadmap item UUID |
title | string | No | New title |
description | string | No | New description |
status | string | No | New status |
category | string | No | New category |
versionId | string | No | New version ID (null to unassign) |
assigneeId | string | No | New assignee (null to unassign) |
isPublic | string | No | Whether publicly visible |
delete_roadmap_item
Delete a roadmap item. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Roadmap item UUID |
vote_roadmap_item
Toggle vote on a roadmap item. Votes if not yet voted, unvotes if already voted. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Roadmap item UUID |
list_roadmap_versions
List all roadmap versions (release milestones) with item counts. No parameters required.
create_roadmap_version
Create a new roadmap version. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Version name (e.g., "v2.0") |
description | string | No | Version description |
targetDate | string | No | Target release date (ISO 8601) |
get_roadmap_settings
Get the roadmap settings for the workspace. No parameters required.
Returns: isPublicEnabled, allowSubmissions, allowVoting.
update_roadmap_settings
Update roadmap settings. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
isPublicEnabled | string | No | Enable public roadmap ("true"/"false") |
allowSubmissions | string | No | Allow public submissions ("true"/"false") |
allowVoting | string | No | Allow voting ("true"/"false") |
Workspace & User
list_workspaces
List all workspaces the authenticated user belongs to. No parameters required.
Returns an array of workspaces with: id, name, slug, description, logoUrl, role, createdAt.
create_workspace
Create a new workspace. The authenticated user becomes the owner. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Workspace display name |
slug | string | Yes | URL-friendly slug (lowercase, hyphens, no spaces) |
logoUrl | string | No | Logo URL for the workspace |
delete_workspace
Permanently delete a workspace and all its data. Only the workspace owner can perform this action. This cannot be undone. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Workspace UUID to delete |
get_workspace
Get details about the current workspace including name, slug, plan, and member/team counts. No parameters required.
update_workspace
Update the current workspace settings. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | No | New workspace name |
description | string | No | New workspace description |
get_current_user
Get the profile of the currently authenticated user. No parameters required.
Returns: id, email, displayName, avatarUrl, createdAt.
update_current_user
Update the current user's profile. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
displayName | string | No | New display name |
avatarUrl | string | No | New avatar URL |
list_user_api_keys
List all personal API keys (velu_ prefix) for the current user. No parameters required.
Returns an array of keys with: id, name, keyPrefix, scopes, lastUsedAt, createdAt.
create_user_api_key
Create a personal API key for the current user. The full key is returned once and cannot be retrieved again. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name for the key (e.g., "CLI Tool") |
scopes | string[] | Yes | Scopes to grant (e.g., user:read, workspaces:list) |
revoke_user_api_key
Revoke a personal API key. This immediately invalidates the key. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | User API key UUID to revoke |
Custom Domains
list_domains
List all custom domains configured for the workspace. No parameters required.
Returns domain name, status (PENDING, VERIFIED, FAILED), CNAME target, and verification details.
add_domain
Add a custom domain. Returns DNS records needed for setup. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | The domain to add (e.g., "issues.example.com") |
Returns setup instructions with two DNS records: (1) a CNAME record pointing to custom.velocity.quest, and (2) a TXT record for domain ownership verification.
verify_domain
Check domain verification status and get setup instructions. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Domain UUID to verify |
remove_domain
Remove a custom domain from the workspace. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Domain UUID to remove |
Claude Agent
transition_issue
Move an issue to a new status by name instead of UUID. Resolves the status name within the issue's team. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
issueId | string | Yes | Issue UUID or identifier (e.g., "ENG-123") |
statusName | string | Yes | Target status name (e.g., "In Progress", "Done") |
get_my_issues
Get issues assigned to the authenticated user with optional status group filter.
| Parameter | Type | Required | Description |
|---|---|---|---|
statusGroup | string | No | Filter by status group: backlog, unstarted, started, completed, cancelled |
limit | number | No | Max results (default 50) |
get_active_sprint
Get the currently active sprint cycle with issue counts and completion progress. No parameters required.
Returns: cycle name, start/end dates, total issues, completed count, progress percentage, and issues breakdown by status.
link_commit
Record a commit SHA against an issue for traceability. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
issueId | string | Yes | Issue UUID or identifier |
commitSha | string | Yes | Git commit SHA |
message | string | No | Commit message |
url | string | No | URL to the commit |
link_pr
Record a pull request against an issue. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
issueId | string | Yes | Issue UUID or identifier |
prUrl | string | Yes | Pull request URL |
title | string | No | PR title |
status | string | No | PR status: open, merged, closed |
get_issue_context
Get rich context for an issue including comments, activity log, labels, and linked integration events.
| Parameter | Type | Required | Description |
|---|---|---|---|
issueId | string | Yes | Issue UUID or identifier |
get_pending_agent_runs
Get pending agent runs for the local_agent tier. Used by the local agent runner to poll for work. No parameters required.
Returns an array of pending runs with: id, trigger_type, trigger_entity_type, trigger_entity_id, metadata, created_at.
update_agent_run
Update an agent run's status, token counts, and result. Requires mcp:write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
runId | string | Yes | Agent run UUID |
status | string | No | New status: running, completed, failed, cancelled |
resultSummary | string | No | Summary of the agent's output |
errorMessage | string | No | Error message if failed |
inputTokens | number | No | Total input tokens used |
outputTokens | number | No | Total output tokens used |
model | string | No | Model used for the run |