Reference

MCP tools

Every tool the server offers an agent, with its arguments. Generated from the server’s own tools/list.

Agents call these over /mcp with an access token; every one is also an endpoint of the REST API. A read tool changes nothing and works with a read-only token. A write tool is recorded in the issue's history under the token's name.

Attachment

`attachment_add`	write	Attach a file to an issue, or to one of its comments: a mock-up, a report, a log, a screenshot.
`attachment_delete`	write	Delete an attachment.
`attachment_upload_url`	write	Get a one-time link to upload a file too large for attachment_add's content_base64 (up to 10 MB).

Comment

`comment_add`	write	Write a comment on an issue.
`comment_list`	read	Read an issue's whole comment thread, oldest first, paginated.
`comment_update`	write	Edit a comment's body or soft-delete it.

Issue

`issue_create`	write	File an issue in a project.
`issue_delete`	write	Soft-delete an issue.
`issue_get`	read	Read one issue before you change it: its type and whether that type is a document, its labels, its 10 newest comments and events with the true totals and truncation flags, and its links both ways.
`issue_history`	read	Read one issue's activity log, newest first: its own changes and its comments', each with its whole before and after.
`issue_list`	read	List issues, newest-updated first; filters combine with AND, 50 by default and 200 at most, and while has_more is true pass next_cursor back as cursor.
`issue_move`	write	Set an issue's project and milestone in one atomic call; issue_update changes neither of those two.
`issue_search`	read	Search issue titles and descriptions for a phrase.
`issue_update`	write	Change an issue's title, description, status, priority, assignee, due date, labels, type, links or place in the project's manual order, or restore one that was soft-deleted.

Label

`label_create`	write	Create a workspace-wide label; bug means the same thing everywhere, so labels are not project-scoped.
`label_list`	read	List every workspace label: an id, a name and a colour each.
`label_update`	write	Rename a label, change its colour, or delete it.

Milestone

`milestone_create`	write	Add a milestone to a project: one chunk of work in the project's ordered sequence.
`milestone_delete`	write	Delete a milestone.
`milestone_list`	read	List a project's milestones in sequence order, with their positions, target dates, issue counts and state.
`milestone_update`	write	Rename a milestone, change or clear its target date, or move it in the project's sequence with position; the other milestones renumber around it.

Project

`project_create`	write	Create a project, the top of the tree.
`project_get`	read	Read one project with its milestones in sequence order and each one's delivery numbers: which are complete, which are no_issues, and whether the project is delivered or overdue.
`project_list`	read	List projects, each with how many of its milestones are complete and whether it is delivered or overdue.
`project_update`	write	Rename a project, change its lead, or archive and unarchive it (archiving is an admin call; an archived project takes no new issues and its existing ones stay readable), or set how agents finish work here: agent_done, one of review, allowed and proof, and done_criteria, the markdown a refusal quotes to the agent it turned away.

Proposal

`proposal_create`	write	Propose a new description for a document.
`proposal_decide`	write	Decide a pending proposal: accept, decline or withdraw.

Type

`type_create`	write	Add an issue type.
`type_update`	write	Rename a type, change its tag or description, switch it between work item and document, or delete it.