MCP Server
Connect AI agents to Velocity via the Model Context Protocol.
What is MCP?
The Model Context Protocol (MCP) is an open standard that lets AI agents interact with external tools through a unified interface. Velocity includes a built-in MCP server that exposes 15 tools for issue tracking, search, and project management.
AI agents like Claude (via Claude Code or Claude Desktop), Cursor, Windsurf, and other MCP-compatible clients can connect to Velocity and create issues, search tasks, update statuses, and manage projects — all without leaving their workflow.
Use Cases
- AI coding assistants — create bug reports directly from code reviews
- Automated triage — agents categorize and prioritize incoming issues
- Status updates — agents update issue progress as they complete work
- Search & context — agents find related issues to inform their work
- Project management — agents create projects, cycles, and milestones
Available Tools
| Tool | Description |
|---|---|
create_issue | Create a new issue with title, description, priority, status |
update_issue | Update an existing issue's fields |
get_issue | Get full details of an issue by ID or identifier |
search_issues | Search issues with filters (status, priority, assignee, text) |
list_issues | List issues with pagination and sorting |
delete_issue | Delete an issue |
create_comment | Add a comment to an issue |
list_projects | List all projects in the workspace |
create_project | Create a new project |
list_cycles | List cycles for a team |
list_teams | List all teams in the workspace |
list_labels | List available labels |
list_statuses | List available statuses |
list_members | List workspace members |
get_workspace | Get workspace information |
Resources
The MCP server also exposes these read-only resources:
velocity://workspace— current workspace metadatavelocity://teams— list of teamsvelocity://labels— list of labels
Next Steps
- Setup & Auth — generate an API key and configure your client
- Tools Reference — detailed parameter docs for each tool