MCP tools

Browse all 49 RyTask MCP tools — the actions an AI agent can take over the Model Context Protocol, each with its required permission and JSON input schema.

RyTask ships an MCP server with 100% workspace control: every service capability has a tool, enforced by an automated parity gate in CI. There are currently 49 tools. Each page below is generated from the same registry the server boots from, so the docs cannot drift from the code.

Tools marked ⚠ are destructive — they do something irreversible, and well-behaved agents should ask before calling them.

Tool	Permission	What it does
`list_projects`	`work:read`	List accessible projects in the workspace (keyset paginated).
`get_project`	`work:read`	Get a single project (requires project:viewer).
`create_project`	`work:write`	Create a project (seeds default statuses + key counter + creator membership).
`update_project`	`work:write`	Update a project's name / description / icon / color / lead.
`archive_project`	`work:write`	Archive or restore a project (hidden from default lists but retained).
`delete_project`	`work:write`	Delete a project (cascade removes its items, statuses, members, counter).
`add_project_member`	`work:write`	Add a member to a project at a role (ADMIN/MEMBER/VIEWER).
`create_issue`	`work:write`	Create a work item (title-only or structured fields).
`quick_add_issue`	`work:write`	Create a work item from a quick-add line (@assignee #label !priority ^date).
`update_issue`	`work:write`	Update a work item's fields (optimistic version; logs activity per field).
`delete_issue`	`work:write`	Soft-delete (trash) a work item.
`restore_issue`	`work:write`	Restore a work item from trash (comments + history intact).
`add_label_to_issue`	`work:write`	Attach a label to a work item (by id or name; create-on-capture).
`remove_label_from_issue`	`work:write`	Remove a label from a work item.
`list_issue_activity`	`work:read`	List a work item's activity / history feed.
`list_labels`	`work:read`	List workspace labels.
`create_label`	`work:write`	Create a workspace label.
`list_issues`	`work:read`	List / filter work items (List, Board, smart views) with keyset pagination.
`get_issue`	`work:read`	Get a single work item (full payload incl. labels).
`move_issue`	`work:write`	Move a work item on the board (change status and/or fractional position).
`add_subtask`	`work:write`	Create a sub-task under a work item (inherits its project; cycle/depth checked).
`list_statuses`	`work:read`	List a project’s statuses (board columns, ordered).
`create_status`	`work:write`	Add a status to a project (mapped to a fixed category).
`update_status`	`work:write`	Rename / recolor / recategorize a status.
`reorder_statuses`	`work:write`	Reorder a project’s statuses (board column order).
`delete_status`	`work:write`	Delete a status (requires reassignTo when it still has items).
`list_views`	`work:read`	List saved views visible to the principal (own personal + shared in projects).
`save_view`	`work:write`	Save a view (filter AST + sort + grouping + layout; personal or shared).
`update_view`	`work:write`	Update a saved view (name / scope / filters / sort / grouping / layout).
`delete_view`	`work:write`	Delete a saved view.
`list_comments`	`work:read`	List threaded comments on a work item.
`add_comment`	`work:write`	Post a markdown comment (@mentions notify + grant context access).
`list_notifications`	`work:read`	List the inbox (unread / all / snoozed / archived), keyset paginated.
`update_notification`	`work:write`	Mark a notification read/unread, snooze it, or archive it.
`search`	`work:read`	Full-text search across work items, comments, projects, labels, and users (ranked, permission-scoped).
`whoami`	`self`	Resolve the current principal: user, org, role, scopes, accessible workspaces.
`list_workspaces`	`workspace:read`	List workspaces in the current organization.
`get_workspace`	`workspace:read`	Get a single workspace by id.
`set_active_workspace`	`workspace:read`	Set the active workspace for the session/principal.
`get_org_settings`	`org:read`	Read the organization settings (timezone, locale, week start, working hours…).
`update_org_settings`	`org:settings:write`	Update organization settings (Owner/Admin).
`transfer_ownership`	`org:transfer`	Transfer organization ownership to another member (Owner only). ⚠
`list_members`	`members:read`	List members of the organization and their roles.
`invite_member`	`members:invite`	Invite a member by email or shareable link, with a pre-assigned role (Admin+).
`set_member_role`	`members:write`	Change a member's role (Admin+; last-owner protected).
`remove_member`	`members:write`	Remove a member; revokes their sessions and tokens (Admin+; last-owner protected). ⚠
`list_api_tokens`	`tokens:read`	List the holder’s own personal access tokens (never the secret).
`create_api_token`	`tokens:write`	Mint a scoped personal access token (secret returned once).
`revoke_api_token`	`tokens:write`	Revoke one of the holder’s own personal access tokens. ⚠

To connect an agent, see Connect an AI agent over MCP.