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:
- image →
 - anything else →
[brief.pdf](media:<id>)
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
sprrint_whoami— confirm identitysprrint_now— see the board- Start work:
sprrint_tasks_move→progress,sprrint_tasks_git_linkthe branch - Decisions:
sprrint_tasks_comment. Commits and PRs:sprrint_tasks_git_link - Finish: link remaining git refs, comment what landed,
sprrint_tasks_move→done 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.