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 |
special | string | no | Comma-separated computed filters, ANDed together: overdue, due_today, due_week, no_due_date, stale (untouched 14d), unassigned, no_estimate, no_project, no_labels, blocked, blocking, unstarted_overdue, mine, created_by_me |
sort | string | no | priority, due, created, updated, title, estimate, state, assignee, each reversible with a '-' prefix. A missing value sorts last ascending, first descending. An unknown key is rejected. Defaults to -updated |
limit | integer | no | |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
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 |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
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 |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
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 |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
move_issue
Move issues to another team and/or project. A team move renumbers the issue under the target team, so the response reports both the old and the new identifier; the old one keeps resolving. Cycles are dropped and states are remapped by name then type. Cross-workspace moves go through move_project.
| Parameter | Type | Required | Description |
|---|---|---|---|
identifiers | string[] | yes | Issue identifiers to move, e.g. ['VOID-12', 'VOID-13'] |
team | string | no | Target team key or id |
project | string | null | no | Target project name or id, or null to detach |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |