MCP tools guide

The tools the Briefboard MCP server exposes to a connected AI agent, grouped by purpose.

Once your AI client is connected, the agent gets a toolbox for reading and updating your project. The tools fall into a few groups.

Developer workflow

The day-to-day loop an agent follows to pick up and complete work:

  • get-next-task — the next priority task assigned to the agent.
  • get-task — full details for a task.
  • get-task-prompt — an implementation prompt, pre-filled with task, milestone, and project context.
  • update-task-status — move a task to in progress or done.
  • add-task-comment — log progress, on the general or technical channel.

Project management

For planning and shaping work:

  • list-projects, get-project-stats — overview and statistics.
  • list-milestones, create-milestone, update-milestone — manage milestones.
  • list-tasks, create-task, update-task, assign-task — manage tasks.
  • list-team-workload — see team capacity.

Specs

Specs are reusable specifications owned at the project level and linked to milestones:

  • list-project-specs, get-spec — browse and read specs.
  • create-spec, update-spec, delete-spec — manage specs.
  • get-milestone-specs, link-spec-to-milestone — connect specs to milestones.

Triage

The team inbox, for items that aren't yet milestones or tasks:

  • list-triage-items, get-triage-item — browse the inbox.
  • create-triage-item, update-triage-item-status — capture and process items.

A note on scope

Tools respect the same permissions and plan limits as the web app. An agent acting as a member can only touch projects that member belongs to, and quota limits still apply. The agent does the work; your roles and plan keep the boundaries.