MCP tools

All tools return JSON. Failures look like { "ok": false, "error": "…", "code": "…" }.

Identify projects by key (BR) or slug (brand-refresh). Identify tasks by key (BR-12).

Tool What it does
sprrint_whoami Signed-in user + workspace
sprrint_workspaces_list Workspaces you belong to
sprrint_workspaces_create Create a workspace
sprrint_overview Workspace home
sprrint_home Project home
sprrint_now Now board (filters: sprint, assigned, due, q)
sprrint_search Tasks, sprints, people
sprrint_activity Activity feed (tab, range, actor, type, q)
sprrint_projects_list Visible projects
sprrint_projects_get One project + members
sprrint_projects_create Create project
sprrint_projects_update Name, description, visibility, default view
sprrint_projects_archive Archive
sprrint_projects_restore Restore by numeric id
sprrint_projects_delete Delete (confirm = name)
sprrint_projects_add_member Add workspace person to project
sprrint_projects_remove_member Remove from project
sprrint_tasks_list List / filter tasks
sprrint_tasks_get Task + comments + files
sprrint_tasks_create Create task (optional parent, blocked_note)
sprrint_tasks_update Edit fields
sprrint_tasks_move Change status (blocked_note, confirm_complete)
sprrint_tasks_comment Comment or reply
sprrint_sprints_list List sprints
sprrint_sprints_get Sprint + tasks
sprrint_sprints_create Create sprint, optional intake
sprrint_sprints_update Edit sprint
sprrint_sprints_start Start a planned sprint
sprrint_sprints_pause Pause an active sprint
sprrint_sprints_complete Mark an active sprint done
sprrint_sprints_delete Delete (move=free)
sprrint_blackhole_list Void tasks
sprrint_blackhole_pull Into landing sprint
sprrint_blackhole_drop Back to the void
sprrint_workspace_get Settings, members, invites, archived
sprrint_workspace_update Name / slug / description
sprrint_workspace_invite Email invite
sprrint_workspace_set_role owner / admin / member
sprrint_workspace_remove_member Remove from workspace
sprrint_profile_update Display name, username, timezone, avatar
sprrint_categories_list Task + sprint categories
sprrint_categories_create Add category
sprrint_categories_delete Remove unused custom category
sprrint_keys_list Your API keys
sprrint_keys_create Mint a key (token shown once)

File uploads stay on the CLI (sprrint files, sprrint tasks attach) because MCP transports are a poor fit for binary files. After upload, pass the returned id as a comment attachment via the API if needed.

Typical agent flow

  1. sprrint_whoami — confirm identity
  2. sprrint_now — see the board
  3. sprrint_tasks_create / sprrint_tasks_move — do the work
  4. sprrint_activity — check what changed