Skip to content
UTSUROIUTSUROI Docs

Tool reference

The tools exposed by the UTSUROI MCP server.

This page is generated from the backend’s tool definitions, so the names, descriptions and arguments are exactly what an MCP client receives.

Scopes are explained in Connecting MCP.

Readmcp:tasks.read

Callable with the read scope alone. If the AI only needs to look, stop at this scope.

get_board_context

Get a board and its lanes, labels, and projects for task creation and updates. The board includes a direct UTSUROI URL.

  • boardIdstringrequired
get_task

Get one UTSUROI task by ID from the authorized tenant. The task includes a boardId and a direct UTSUROI URL.

  • idstringrequired
list_boards

List boards in the authorized UTSUROI tenant. Each board includes a direct UTSUROI URL.

Arguments: none

list_due_tasks

List tasks by due date range. Use dueDateTo for overdue/today/week queries. Each task includes a boardId and a direct UTSUROI URL.

  • boardIdstring
  • dueDateFromstring
  • dueDateTostring
  • includeArchivedboolean
  • limitinteger
list_labels

List labels for a board in the authorized tenant.

  • boardIdstringrequired
list_lanes

List lanes for a board in the authorized tenant.

  • boardIdstringrequired
list_members

List active members in the authorized tenant for assignee and ball holder updates.

Arguments: none

list_my_tasks

List tasks assigned to or held by the authorized user across all accessible boards by default. Set perspective to created for tasks created by the user, or assigned-or-created for both. Open tasks are returned by default. Each task includes board and lane context plus a direct UTSUROI URL. Follow nextCursor with the same filters until it is null to retrieve every page.

  • boardIdstring
  • perspectivestring
  • statusstring
  • cursorstring
  • includeArchivedboolean
  • limitinteger
list_projects

List projects for a board in the authorized tenant.

  • boardIdstringrequired
list_recent_task_events

List recent task history events across the authorized tenant, optionally scoped to a board. Each event includes a direct URL to its task.

  • boardIdstring
  • limitinteger
list_recurring_tasks

List active recurring task templates in the authorized tenant.

Arguments: none

list_task_activities

List all task activity in the authorized tenant with cursor pagination. Filter by board, task, actor, event kind, or time range. Archived tasks are included and each activity includes a direct task URL. Follow nextCursor until it is null to retrieve the complete result set.

  • cursorstring
  • limitinteger
  • boardIdstring
  • taskIdstring
  • actorIdstring
  • kindsarray
  • fromAtinteger
  • toAtinteger
search_tasks

Search UTSUROI tasks in the authorized tenant by title or description. Each task includes a boardId and a direct UTSUROI URL.

  • querystring
  • boardIdstring
  • includeArchivedboolean
  • limitinteger

Writemcp:tasks.write

Requires the write scope. Users with the viewer role cannot call these regardless of scope.

add_task_comment

Add a comment to a task and return the task URL. Requires mcp:tasks.write.

  • idstringrequired
  • bodystringrequired
archive_task

Soft-archive a task, optionally including subtasks, and return the target task URL. Requires mcp:tasks.write.

  • idstringrequired
  • includeDescendantsboolean
create_label

Create a label on a board and return the board URL. Color is optional and defaults to a preset when omitted. Requires mcp:tasks.write.

  • boardIdstringrequired
  • namestringrequired
  • colorstring
create_project

Create a project on a board and return the board URL. Color is optional and defaults to a preset when omitted. Requires mcp:tasks.write.

  • boardIdstringrequired
  • namestringrequired
  • colorstring
create_recurring_task

Create a recurring task template that auto-generates tasks on a daily/weekly/monthly schedule and return its board URL. Requires mcp:tasks.write.

  • boardIdstringrequired
  • laneIdstringrequired
  • titlestringrequired
  • frequencystringrequired
  • descriptionstring
  • projectIdany
  • sizestring
  • ballHolderIdany
  • assigneeIdsarray
  • labelIdsarray
  • runHourinteger
  • weekdaysarray
  • dayOfMonthinteger
  • timezonestring
  • startOffsetDaysinteger
  • dueOffsetDaysinteger
  • endDateany
  • enabledboolean
create_task

Create a task in the authorized tenant and return its direct UTSUROI URL. Assignees, ball holder, and labels can be set at creation time. Requires mcp:tasks.write.

  • boardIdstringrequired
  • laneIdstringrequired
  • titlestringrequired
  • descriptionstring
  • dueDatestring
  • startDatestring
  • parentIdany
  • projectIdany
  • sizestring
  • orderinteger
  • assigneeIdsarray
  • ballHolderIdany
  • labelIdsarray
create_tasks

Create multiple tasks in the authorized tenant. Returns created items with direct UTSUROI URLs and failed items by input index. Requires mcp:tasks.write.

  • itemsarrayrequired
move_task

Move a task to another lane/parent/order and return the task URL. Requires mcp:tasks.write.

  • idstringrequired
  • laneIdstringrequired
  • parentIdany
  • orderintegerrequired
restore_task

Restore a soft-archived task, optionally including subtasks, and return the target task URL. Requires mcp:tasks.write.

  • idstringrequired
  • includeDescendantsboolean
set_task_assignees

Replace task assignees and ball holder and return the task URL. Requires mcp:tasks.write.

  • idstringrequired
  • assigneeIdsarray
  • ballHolderIdany
set_task_labels

Replace task labels and return the task URL. Requires mcp:tasks.write.

  • idstringrequired
  • labelIdsarray
update_task_fields

Update base task fields such as title, description, dates, project, or size and return the task URL. Requires mcp:tasks.write.

  • idstringrequired
  • titlestring
  • descriptionany
  • dueDateany
  • startDateany
  • baselineStartDateany
  • baselineDueDateany
  • projectIdany
  • sizeany

Board settings (opt-in)mcp:boards.settings

Not exposed by default. These appear in tools/list only when this scope is explicitly granted.

get_board_settings

Read board settings, card defaults, Slack mappings and notification configuration. Requires mcp:boards.settings.

  • boardIdstringrequired
list_board_slack_channels

Discover Slack channel candidates. available=false means the channel is linked to another board and cannot be selected for a mapping. Requires mcp:boards.settings.

  • boardIdstringrequired
set_board_slack_channels

Replace this board's complete Slack channel mappings. Read current settings and merge for add/remove requests. Other boards and workspace Slack settings are preserved. May join the Slack bot to selected channels. Requires mcp:boards.settings.

  • boardIdstringrequired
  • mappingsarrayrequired
set_board_slack_comment_notify_config

Set whether card comments are sent to Slack and optionally change the destination channel. Omitted channelId is preserved. Requires mcp:boards.settings.

  • enabledbooleanrequired
  • channelIdany
  • boardIdstringrequired
set_board_slack_unresponded_config

Replace enabled state and the complete channelIds selection for unanswered mentions. Channels must already be linked to this board. Requires mcp:boards.settings.

  • enabledbooleanrequired
  • channelIdsarray
  • boardIdstringrequired
update_board_settings

Partially update basic settings, card defaults or Slack notification fields. Omitted fields are preserved; cardDefaults replaces the complete defaults object. Does not change board access, recurring tasks or archive state. Requires mcp:boards.settings.

  • namestring
  • colorstring
  • sizingEnabledboolean
  • sizePointsany
  • countUnsizedTasksAsOneboolean
  • cardDefaultsany
  • cardDefaultsApplyToSlackboolean
  • slackDueNotificationEnabledboolean
  • slackDueNotificationHourinteger
  • slackDueNotificationTimezonestring
  • slackDueNotificationChannelIdany
  • slackDueNotificationChannelEnabledboolean
  • slackDueNotificationChannelHourinteger
  • slackDueNotificationChannelThreadEnabledboolean
  • slackCompletionChannelEnabledboolean
  • slackCompletionChannelIdany
  • slackTaskTriggerReactionstring
  • slackUnrespondedTaskEnabledboolean
  • slackUnrespondedAiJudgeEnabledboolean
  • slackAiRoutingEnabledboolean
  • slackAiTitleEnabledboolean
  • slackDueNotificationMethodstring
  • slackDueNotificationDmMethodstring
  • slackDueNotificationChannelMethodstring
  • groupany
  • boardIdstringrequired