coLab over MCP

The account behind this connection, what it may do, and the workspaces it can reach. Call this first when you need a workspace id, or to check whether you have write access before attempting a change.

Full-text search across projects, tasks, notes, milestones, decisions, comments, chat messages, attachments, links, previews and review pins — everything this account can reach. Prefix a name with @ to narrow to one person's work (@me for your own). Wrap the query in double quotes to suppress spelling correction. This is the fastest way to find something when you do not already have its id.

Every project this account can open, newest first. Archived ones are held back unless asked for.

A project's current state: its details and your access to it, whatever is pinned to its board, its milestones, its open tasks (by default), and its most recent decisions. Prefer this over several narrower calls when you are picking up work on a project — it is one round trip instead of five. The board is where standing information lives: what the project is for, how it is run, who decides.

Everyone and every agent an @ can name in this project, each with the exact text to write after the @. Call this before putting a mention in a task, a comment or a reply. A person is named by their display name and an agent by its handle — different fields, easy to confuse, and a mention that does not match is silently kept as plain text that notifies nobody and starts no agent run. Mentioning an agent is what triggers it, so this is also how you hand work to one.

Starts a new project in a workspace you belong to. The workspace is inferred when there is only one it could be.

Changes any subset of a project's fields. A field left out is left alone. Set archived to put a project away or bring it back.

Tasks across every project you can reach, newest first, or within one project when you name it. This is the cross-project view the app itself does not really offer — "everything assigned to me that is overdue" is one call.

A task with its full comment thread, its links, and its attachment list. Use this rather than listing tasks and reading one out of the page — the list omits the thread, which is usually where the actual requirement is written down.

Adds a task to a project. Mentioning someone as @Name in the details notifies them, and any URL in the details is attached as a link automatically.

Changes any subset of a task's fields. A field left out is left alone; a field sent as null is cleared — so you can reassign a task without first reading it back to avoid blanking its due date.

todo → doing → done, and done wraps back to todo. The one-field change worth having as its own verb, since it needs no knowledge of where the task currently is.

Adds a comment. @Name mentions notify that person, so this is how to actually reach someone about a task rather than only recording something next to it.

Every preview registered on a project — staging URLs and deploy previews people are commenting on — newest first, each with its count of unresolved notes.

Neither hosted_url nor url here is a link to hand somebody: the first is a gated origin that refuses a request without a ticket, and both open the build with no review overlay. Call colab_preview_review_link for an address that opens. app_url opens the preview inside coLab for someone already signed in.

Notes reviewers pinned on a preview, newest first, each with its whole conversation and the task it became. status: "open" is the query worth having — it is the list of what the build still owes somebody.

A single pinned note with its full conversation and, when the reviewer's browser captured one, the screenshot of what they were looking at — returned as an image you can actually see. Use this before answering or acting on a review note.

The link that actually opens a build, and the one-line snippet that has to be installed on it for review to work at all.

Use this — never hosted_url — whenever the answer is 'go look at the preview'. hosted_url is only where the files answer: it sits on an origin that receives no coLab session, so it is refused without a ticket, and even when it loads it shows the bare build with no overlay, which is exactly where the pinned notes are. This link mints the ticket and turns the overlay on.

Pass at to land on a particular page, so a note left deep in a flow opens where it was left. Requires edit access to the project. The link is a credential — anyone holding it can comment on the build — so hand it out deliberately.

Replies on a pinned note. The reply appears in the overlay on the build itself, not only inside coLab — so the person who pinned 'this is wrong on mobile' is told it is fixed on the page where they said it, without an account and without being emailed. Refused once the review is closed.

Marks a pinned note resolved once it has been dealt with, or reopens one that was closed too early. Reversible either way.

Creates a task that quotes the pinned note — its text, any suggested copy change, and where on the build it was left — so whoever picks it up need not open a preview URL that may have stopped resolving. A pin that is already a task is refused rather than duplicated.

Every note on a project, newest first. Content is included, so this is often enough on its own — reach for colab_get_note only when you need one in full.

A note's durable markdown snapshot plus its [[wiki-links]], backlinks, linked tasks, anchored comment threads, tags, typed properties, and your private favorite/visit state. Note that someone editing it live may be looking at something newer than this.

The caller's private favorites and recently visited notes in one project.

Saved dynamic filters and the notes currently matching each one.

Reusable title and Markdown defaults, including workspace templates when accessible.

What a project has settled, newest first. Entries are written once and never edited — read this before proposing a direction, so you do not reopen something the team has already closed.

Creates a blank/populated note or copies an accessible template. Explicit title/content override template defaults.

Changes only the caller's private favorite state.

Saves reusable title and Markdown defaults for one project or the workspace.

Changes future instantiations without touching notes already created from it.

Deletes the reusable definition only; existing notes stay unchanged.

Sets tags and typed properties without changing Markdown.

Creates a shared dynamic metadata filter.

Renames it and/or replaces its dynamic filter.

Deletes only the saved filter.

Starts an anchored discussion without changing the note's Markdown.

Edits the author's opening message and/or resolves or reopens its thread.

Adds a reply to an anchored note thread.

Edits a reply authored by this caller.

Deletes a thread and its replies; the note's Markdown is untouched.

Deletes one reply and leaves the thread intact.

Idempotently links existing work to the project note that supports it.

Removes only the relationship; neither the note nor task is deleted.

Appends an entry to the decision log. Entries cannot be edited afterwards, only struck — so write what was decided and why, not a draft of it.