Overview
When the workstation is running, it exposes MCP (Model Context Protocol) tools that AI agents can call to interact with tickets and the project. These tools are available through the MCP server configured in your agent's settings.
ticket_get
Retrieve a ticket by its ID.
Parameters
| Name | Type | Description |
|---|---|---|
ticketId | string | The ticket ID (e.g., MA-5) |
Returns
The full ticket object including title, description, status, priority, assignee, tags, comments, and metadata.
ticket_list
List tickets with optional filters.
Parameters
| Name | Type | Description |
|---|---|---|
status | string (optional) | Filter by status: open, in-progress, done, closed |
assignee | string (optional) | Filter by assignee name |
tag | string (optional) | Filter by tag |
Returns
An array of ticket summaries (ID, title, status, priority, assignee).
ticket_create
Create a new ticket.
Parameters
| Name | Type | Description |
|---|---|---|
title | string | Ticket title |
description | string (optional) | Markdown description |
priority | string (optional) | low, medium, high, or critical |
tags | array (optional) | List of tag strings |
Returns
The created ticket object with its assigned ID.
ticket_update
Update one or more fields on an existing ticket.
Parameters
| Name | Type | Description |
|---|---|---|
ticketId | string | The ticket ID to update |
title | string (optional) | New title |
description | string (optional) | New description |
status | string (optional) | New status |
priority | string (optional) | New priority |
assignee | string (optional) | New assignee |
tags | array (optional) | New tags (replaces existing) |
Returns
The updated ticket object.
ticket_comment
Add a comment to a ticket's thread.
Parameters
| Name | Type | Description |
|---|---|---|
ticketId | string | The ticket ID |
body | string | Comment text (Markdown supported) |
Returns
The created comment object.
ticket_current
Get the ticket associated with the current worktree. This is determined by the working directory — if the agent is running inside a worktree, this returns the linked ticket.
Parameters
None.
Returns
The ticket object for the current worktree, or an error if not in a worktree.