BakedBrie docs

Tool reference

Each tool is listed only while its capability is on. Call whoami to see which capabilities are on for your workspace. A tool whose capability is off answers CAPABILITY_OFF.

Boards and cards

  • [add_comment](/docs/reference/tools/add_comment): Add a comment to an accessible card.
  • [create_board](/docs/reference/tools/create_board): Create a board.
  • [create_card](/docs/reference/tools/create_card): Create a card on an accessible board.
  • [list_boards](/docs/reference/tools/list_boards): List boards.
  • [list_cards](/docs/reference/tools/list_cards): List cards on a board.
  • [move_card](/docs/reference/tools/move_card): Move a card after a preview.
  • [preview_move](/docs/reference/tools/preview_move): Preview a card move.
  • [read_board](/docs/reference/tools/read_board): Read one board.
  • [read_card](/docs/reference/tools/read_card): Read one card.
  • [read_docs](/docs/reference/tools/read_docs): Read the BakedBrie docs without leaving this connection.
  • [reorder_card](/docs/reference/tools/reorder_card): Reorder a card inside its list with exactly one anchor.

Capability: agents

  • [create_agent_draft](/docs/reference/tools/create_agent_draft): Create a draft agent on a board: name, instructions and permissions.
  • [list_ai_models](/docs/reference/tools/list_ai_models): The AI models BakedBrie offers per provider (anthropic, openai), with each provider's default marked.
  • [manage_agent](/docs/reference/tools/manage_agent): Change an agent.
  • [manage_board_guidelines](/docs/reference/tools/manage_board_guidelines): Board guidelines: standing guidance every agent on the board gets with each run (brand voice, formats, dos and don'ts).
  • [publish_agent](/docs/reference/tools/publish_agent): Publish the agent's current draft as a new version and make it active.
  • [set_agent_model](/docs/reference/tools/set_agent_model): Choose the model an agent uses, or pass null for the provider default.

Capability: ai_accounts

  • [bind_ai_account](/docs/reference/tools/bind_ai_account): Choose which AI account pays for work: the whole workspace, one board, or one agent (an agent binding wins, then the board, then the workspace).
  • [check_ai_account](/docs/reference/tools/check_ai_account): Health of an AI account.
  • [connect_ai_account](/docs/reference/tools/connect_ai_account): Connect the user's own OpenAI or Anthropic key.
  • [list_ai_accounts](/docs/reference/tools/list_ai_accounts): AI accounts connected in this workspace (kind, provider, label, health) and where each is bound.
  • [remove_ai_account](/docs/reference/tools/remove_ai_account): Remove an AI account for good: its key is destroyed, and every workspace, board and agent choice that named it is cleared.
  • [replace_ai_account_key](/docs/reference/tools/replace_ai_account_key): Replace the key of the user's own OpenAI or Anthropic AI account, keeping its id, label, bindings and agents.
  • [unbind_ai_account](/docs/reference/tools/unbind_ai_account): Clear which AI account pays for the whole workspace (workspace owner or admin) or for one board (board manage permission).

Capability: connection_webhooks

  • [manage_connection_webhook](/docs/reference/tools/manage_connection_webhook): Create, read, pause and resume QuickBooks or Xero webhooks and their card rules.

Capability: connections

  • [manage_board_connection](/docs/reference/tools/manage_board_connection): Let one board use a connection (an attachment): list, get, attach, update, detach, usage and lower_limits.
  • [manage_connection](/docs/reference/tools/manage_connection): Connect a service by header key or OAuth.
  • [manage_connection_request](/docs/reference/tools/manage_connection_request): Read and act on calls to connected services: list a card's calls (newest first, each with its state, receipt and output files), get one, needs_you (calls waiting on a person across the boards you can work on), cancel, check_again (once, for a call that has not finished in time), give_up, and continue (ask the card's agent to continue with the result).
  • [manage_connection_step](/docs/reference/tools/manage_connection_step): A column step makes one call when a card enters a column, once per round of work on the card, then can move the card on: list, get, create, update, pause and resume.
  • [request_connection](/docs/reference/tools/request_connection): Make one call to a connected service for a card, as a person would with Use a connection: preview, then create.

Capability: control

  • [list_send_modes](/docs/reference/tools/list_send_modes): Read automatic sending mode, consent status and limits for every automation on a board.
  • [list_send_receipts](/docs/reference/tools/list_send_receipts): Read this board’s automatic send receipts and provider outcomes.
  • [manage_stages](/docs/reference/tools/manage_stages): Customize a board's columns.
  • [rename_workspace](/docs/reference/tools/rename_workspace): Rename this workspace (every workspace starts as "My workspace").
  • [whoami](/docs/reference/tools/whoami): Who this token acts as: workspace, your role, token preset, which capabilities are on, connected AI accounts (each with its kind: api_key, or runner for the user's own Claude Code or Codex on their computer) and destinations, the user's connected computers (runners, when that capability is on), and the app URL.

Capability: destinations

  • [list_results](/docs/reference/tools/list_results): List finished cards with their result (summary markdown, hash, outputs) and each delivery with its full receipt (pull request URL, commit, object key or Drive file id; every output file with name, media type, sha256, external ids, and the approver when a review approved it), plus approved_files (each approved work-folder file by its approved version name and sha256, with the completion delivery that carried it) and, for API deliveries that declare them, followups (the publish status poll and the 24h/7d stats reads: state, due and done times, per target status with live link or error, or metric numbers), newest first, filterable by board and date.
  • [manage_board_hooks](/docs/reference/tools/manage_board_hooks): List, set or clear a board's hooks.
  • [manage_destination](/docs/reference/tools/manage_destination): Create, read, update, test or disable a destination (where finished work goes: a GitHub pull request, your own S3/R2 bucket, a Google Drive folder, or an API destination: the Slack or WoopSocial preset or a custom API, which needs the API workflow feature), and set a board default or a card override.
  • [redeliver](/docs/reference/tools/redeliver): Retry one failed or outcome-unknown delivery under its original idempotency key.

Capability: dispatch

  • [pause_workspace_dispatch](/docs/reference/tools/pause_workspace_dispatch): Emergency stop: pause every V2.1 run, delivery, media job and run_now in this workspace at once.
  • [resume_workspace_dispatch](/docs/reference/tools/resume_workspace_dispatch): Resume V2.1 runs, deliveries and media jobs after pause_workspace_dispatch.

Capability: external_jobs

  • [manage_job_step](/docs/reference/tools/manage_job_step): Development only.

Capability: inbound

  • [manage_inbound_endpoint](/docs/reference/tools/manage_inbound_endpoint): Create, read, list, update or disable an inbound endpoint: a signed URL that turns a Slack message (preset slack: top-level messages from people in the chosen channels) or a signed JSON webhook (preset generic) into one card on a board, in a chosen column, owned by you.
  • [manage_member_mapping](/docs/reference/tools/manage_member_mapping): List, set or remove the link between a Slack user and a BakedBrie member.

Capability: media

  • [attach_link](/docs/reference/tools/attach_link): Attach a file to a card by link to the user's own storage.
  • [attach_local_file](/docs/reference/tools/attach_local_file): Attach a file from the user's device (for example ~/Desktop/ad.mp4) without the bytes passing through this conversation.
  • [attach_provider_file](/docs/reference/tools/attach_provider_file): Attach a file that is already in the user's own AI provider file store (upload it there from the user's device with the user's own key first; never send that key to BakedBrie).
  • [get_output](/docs/reference/tools/get_output): Get one output of a card's result: the provider-hosted link, the destination link it was delivered to, or the render source (markdown, CSV, render spec) to render locally into a PDF, spreadsheet or video.
  • [list_card_files](/docs/reference/tools/list_card_files): List a card's files: source (link, provider file, upload), type, size, sha256, state (pending, processed, refused with a code) and derived text (transcript, keyframe hashes, extracted text, metadata).
  • [pair_device](/docs/reference/tools/pair_device): Pair the local drop helper on the user's computer with one board: returns a single-use pairing code (10 minutes) and the commands to run on that computer.
  • [prepare_transient_upload](/docs/reference/tools/prepare_transient_upload): Get a single-use upload URL (PUT, bearer token, 15 minutes) for one file on a card.

Capability: reviews

  • [decide_review](/docs/reference/tools/decide_review): Approve, reject or request changes on one review, as the token's own user (the receipt names them).
  • [get_review](/docs/reference/tools/get_review): Read one review: the exact file under review (work-folder destination, path, sha256, bytes, media type), maker, named reviewer and the intent_hash you must pass to decide_review.
  • [list_reviews](/docs/reference/tools/list_reviews): List review items (files waiting in a work folder's Needs review/) with state, maker, reviewer and file hash.
  • [set_work_folder](/docs/reference/tools/set_work_folder): Name the board's work folder (an S3/R2 destination, or the board's own bakedbrie_storage folder when BakedBrie storage is on): BakedBrie creates Inbox/, Needs review/, Approved/ and Done/ there and agent output waits in Needs review/ for a decision.

Capability: secrets

  • [prepare_secret](/docs/reference/tools/prepare_secret): Get a single-use, 10-minute secret drop so a key goes from the user's environment to BakedBrie without entering this conversation.

Capability: setup

  • [setup_board](/docs/reference/tools/setup_board): One call for a whole setup: board, columns, agent (draft then publish), AI account binding, rule, schedule, destination and seed cards.
  • [undo_setup](/docs/reference/tools/undo_setup): Reverse one setup_board within 24 hours, unless someone has edited the board since: pauses its rule and schedule, retires its agent, disables its destination and archives the board.

Capability: triggers

  • [author_workflow_draft](/docs/reference/tools/author_workflow_draft): Draft a rule for a board: when a card is in one column, the agent works on it, then the card moves to another column.
  • [get_trigger_source](/docs/reference/tools/get_trigger_source): Read one service change trigger and its current setup and verification state.
  • [list_trigger_sources](/docs/reference/tools/list_trigger_sources): Read service change triggers on a board, including state, provider and verification health.
  • [list_triggers](/docs/reference/tools/list_triggers): Every rule and schedule with its state, next run, last error and backlog, optionally for one board.
  • [manage_schedule](/docs/reference/tools/manage_schedule): Schedules that create cards.
  • [publish_workflow](/docs/reference/tools/publish_workflow): Turn a drafted rule on (action "publish", default) or off (action "pause").

View as Markdown