MCP tools

These tools are served at https://mcp.sprrint.run/mcp. 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).

Projects belong to a workspace. sprrint_projects_list with no workspace argument returns every project you can see, in every workspace, and each row includes workspace.slug and workspace.name. Match the project there before creating one. A Slack channel name is not a project key.

X-Workspace-Slug still selects the active workspace for calls that omit workspace. Pass workspace (the workspace slug) on a tool to target that workspace for that call only. A project key that exists in only one workspace is found without workspace. The active workspace is checked first. If the same key exists in more than one workspace, the tool returns ambiguous_project and the matching projects, and the next call must pass workspace.

Archived projects stay off the list. A private project stays hidden until you are a member or a workspace manager.

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. Optional workspace slug
sprrint_home Project home
sprrint_now Now board (filters: sprint, assigned, due, q)
sprrint_search Tasks, sprints, people. A unique project key is found across workspaces
sprrint_activity Activity feed (tab, range, actor, type, q)
sprrint_projects_list Every visible project, or one workspace when workspace is set
sprrint_projects_get One project + members
sprrint_projects_create Create project. Pass workspace or it lands in the active workspace
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 + git_refs + description_files
sprrint_tasks_create Create task (optional parent, blocked_note)
sprrint_tasks_update Edit fields. Description is the full markdown body
sprrint_files_upload Upload description bytes as base64. Returns markdown to embed
sprrint_tasks_move Change status (blocked_note, confirm_complete)
sprrint_tasks_comment Comment or reply
sprrint_tasks_git_link Link a PR URL, branch, or commit SHA to a task
sprrint_tasks_git_unlink Remove a git ref (ref_id from git_refs)
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)

Description and comment files

sprrint_tasks_create, sprrint_tasks_update, and sprrint_tasks_comment take an optional files list. Each item is source_url or content_base64, plus optional filename and content_type.

source_url is an https link. Sprrint downloads that file and attaches it. The link must be reachable with no login. Private, loopback, and link-local addresses are refused. Do not generate base64 for a screenshot. content_base64 is for bytes a program already encoded. The server does not read a local path.

On create and update, each file's markdown is appended to the description:

On update, omit description to keep the current text, including existing media: tokens. The new markdown is appended after it. On comment, files become attachments. file_ids attaches files that were already uploaded. A comment can be a file with an empty body.

sprrint_files_upload stores a file and returns id, name, content_type, kind, size, url, role, and markdown without attaching it. Pass source_url or content_base64. Use it when the markdown has to sit in the middle of a description: upload, then send the full description with that snippet in place.

sprrint_tasks_get returns the same tokens in description and metadata in description_files (id, name, content_type, kind, size, url, role, label, markdown, missing). Task attachments are a separate list and do not replace inline description files. Comment files come back on the comment as attachments.

Limits match the web app: 25 MB. Types: png, jpeg, gif, webp, mp4, webm, quicktime, pdf, txt, md, doc, docx. A failed upload writes no file and does not change the task or comment. If the upload succeeds and the save fails, retry the save with the same id. Do not upload again. Unused uploads stay in the project library until someone deletes them.

sprrint files ./shot.png remains the CLI path for a local file.

Git refs

sprrint_tasks_get returns git_refs: {id, kind, ref, url, title, label, short_ref, repository}.

kind is pull_request, branch, or commit. Paste a GitHub / GitLab / Gitea / Bitbucket URL, a branch name, or a SHA into value. Optional kind and title. A duplicate returns { "ok": false, "error": "Already linked." } with the existing git_ref.

Do not put these in the description. Use the git-work skill so an agent also moves status and comments decisions.

Typical agent flow

  1. sprrint_whoami — confirm identity
  2. sprrint_now — see the board
  3. Start work: sprrint_tasks_move → progress, sprrint_tasks_git_link the branch
  4. Decisions: sprrint_tasks_comment. Commits and PRs: sprrint_tasks_git_link
  5. Finish: link remaining git refs, comment what landed, sprrint_tasks_move → done
  6. sprrint_activity — check what changed

QA workflow

sprrint_tasks_move(key, status, qa_body?, qa_owner_id?, project?, workspace?) accepts all QA stages. The first qa_ready move requires no message. qa_progress starts testing; if unassigned, the person starting becomes QA owner. qa_failed uses saved testing notes or requires qa_body. Resubmitting a failed round to qa_ready requires qa_body, which becomes the previous round's editable engineer response. A new numbered round is created. Moving back to engineering never removes history.

sprrint_tasks_qa(key, action, body?, round_id?, owner_id?, file_ids?, project?, workspace?) supports round_notes and round_response to edit the single note or response for a round. Omit round_id for the current round. Read IDs, testing_notes, engineer_response, results and timestamps in qa.rounds from sprrint_tasks_get. The QA owner edits testing notes and passes QA; project members can edit engineer responses. Normal completion uses testing notes and requires all subtasks done. No individual finding replies or verification steps are required.

Use configure with owner_id to assign the tester, and enable/disable to toggle QA at any time without deleting history. submit, start, pass and fail remain supported. Legacy finding/reply/fix/verify/reopen actions remain available for existing clients. Notes and responses support inline media:ID references and file_ids scoped to the project. sprrint_tasks_list(status="qa_failed", sprint="all") locates failed work. sprrint_projects_update(qa_required_by_default=true) sets the default for new tasks.