MCP tool reference
Issues
MCP tools for issues.
Generated from the live tool catalog in packages/mcp/src/server.ts. Run pnpm mcp-docs in apps/docs to regenerate after changing a tool.
list_issues
List or search issues. All filters optional. Use q for full-text search on title/description.
| Parameter | Type | Required | Description |
|---|---|---|---|
team | string | no | Team key (e.g. VOID) or id |
state | string | no | Workflow state name (requires team) |
stateType | string | no | Comma-separated state types: backlog,unstarted,started,completed,canceled |
assignee | string | no | User email, id, or 'me' |
project | string | no | Project name or id |
cycle | string | no | Cycle number, id, or 'current' (requires team) |
q | string | no | Search query |
limit | integer | no |
get_issue
Get a single issue by identifier (e.g. VOID-12), including comments and sub-issues.
| Parameter | Type | Required | Description |
|---|---|---|---|
identifier | string | yes | Issue identifier like VOID-12, or issue id |
create_issue
Create an issue in a team.
| Parameter | Type | Required | Description |
|---|---|---|---|
team | string | yes | Team key (e.g. VOID) or id |
title | string | yes | |
parent | string | no | Parent issue identifier to create a sub-issue |
description | string | no | Markdown description |
state | string | no | Workflow state name, e.g. 'In Progress' |
priority | integer | no | 0=none 1=urgent 2=high 3=medium 4=low |
estimate | number | no | Points on the team's estimate scale (0.5 supported) |
assignee | string | no | User email, id, or 'me' |
project | string | no | Project name or id |
cycle | string | no | Cycle number, id, or 'current' |
labels | string[] | no | Label names (missing ones are created) |
dueDate | string | no | YYYY-MM-DD |
update_issue
Update an issue. Only provided fields change. Set state to a completed-type state (e.g. 'Done') to close.
| Parameter | Type | Required | Description |
|---|---|---|---|
identifier | string | yes | Issue identifier like VOID-12 |
title | string | no | |
description | string | no | Markdown description |
state | string | no | Workflow state name, e.g. 'In Progress' |
priority | integer | no | 0=none 1=urgent 2=high 3=medium 4=low |
estimate | number | no | Points on the team's estimate scale (0.5 supported) |
assignee | string | no | User email, id, or 'me' |
project | string | no | Project name or id |
cycle | string | no | Cycle number, id, or 'current' |
labels | string[] | no | Label names (missing ones are created) |
dueDate | string | no | YYYY-MM-DD |