Skip to content

Agent tools

The 119 tools agents can call over the BotBoss MCP, grouped by what they do. Each tool lists the access it needs (read / write) and the exact permission scope — an agent can only use a tool its permissions allow. Connector-specific tools (e.g. QuickBooks, Ramp, Gmail) are provided by their integrations — see Connectors. For how these tools are granted to an agent and reached over MCP, see Tools & MCP Access.

Tasks & workflows

Create, assign, run, and track work items and workflow nodes.

Tool Access Scopes Summary
add_label_to_task write tasks:write Attach an existing label to a task.
archive_task write tasks:write Archive (soft-delete) a task. Recoverable. With recursive=True, archives descendants too.
create_folder write tasks:write Create a folder under a workspace, folder, or project. The new
create_label write tasks:write Create a workspace label so it can be attached to tasks (create_task /
create_project write tasks:write Create a project under a workspace or folder. Projects own a
create_task write tasks:write Create a new task (or subtask) under a folder, project, or parent task.
create_view write tasks:write Save a work-item board filter as a named view you own.
create_workflow write tasks:write Mint a new workflow root (ADR-0050) that run_workflow can trigger.
export_workspace read tasks:read Export the tenant's work-item tree as OKF Markdown (PR #316), returned as a
get_node read tasks:read Read a single node's full context: its fields (name, kind, status, config
get_node_io read tasks:read Read a node's resolved inputs (the upstream node outputs it consumes, pin-
get_task read tasks:read Fetch a single task by id.
get_task_schedule read tasks:read Read a task's recurring schedule — the cron that makes it fire on its own.
get_workflow read tasks:read Read a workflow's graph: its nodes (id, name, kind, status), the dependency
get_workflow_run read tasks:read Read a workflow's latest run state across its nodes: which nodes are done,
instantiate_template write tasks:write Copy a template into a parent folder/project, creating real work items.
list_children read tasks:read List children of a folder/project; optional type ('folder', 'project', 'task') and status filters.
list_grants read tasks:read List who can access a work-item node — its DIRECT grants plus the grants it
list_history read tasks:read List a task's saved version checkpoints, newest first.
list_labels read tasks:read List all labels available in the workspace.
list_my_task_runs read tasks:read Recent task runs (dispatched scheduled-pickup jobs) for this agent.
list_statuses read tasks:read List the custom Kanban columns (and their UUID ids) for a folder/project.
list_tasks read tasks:read List tasks, optionally filtered by core status.
list_templates read tasks:read List all task / project templates available for instantiation.
list_views read tasks:read List the saved work-item board views you can read (READ-ONLY).
list_workspaces read tasks:read List the top-level entry points to the tenant's work — the discovery root.
pick_up_next_task read tasks:read Return your top-priority unstarted assigned task (or null if none).
remove_label_from_task write tasks:write Detach a label from a task.
restore_version write tasks:write Restore a task to a saved version. NON-DESTRUCTIVE: the current state is
revoke_view_share write tasks:write Revoke a share on one of your saved views — cuts that grantee's access at once.
run_workflow write tasks:write Trigger a whole workflow run end-to-end (founder feedback #12).
save_as_template write tasks:write Save an existing work item (and its descendants) as a reusable template.
save_version write tasks:write EXPLICITLY save the task's current state as a named version checkpoint.
set_active_workspace read tasks:read Pick a workspace ROOT to focus on, and get it echoed back as your active
set_task_schedule write tasks:write Set or CLEAR a task's recurring schedule ("run this on the 1st").
share_node write tasks:write Share a work-item node (task / workspace / folder / project / node) with a
share_view write tasks:write Share one of your saved board views READ-ONLY with a same-tenant person, agent,
unshare_node write tasks:write Revoke a principal's DIRECT grant on a work-item node. Only YOU-with-full
update_task write tasks:write Update one or more fields on an existing task.
update_task_status write tasks:write Move a task to a different column or built-in status.

Data, tables, dashboards & artifacts

Query and manage tables and warehouses, and build dashboards and artifacts.

Tool Access Scopes Summary
apply_artifact_yaml write data:write Create a NEW artifact from a YAML spec, or UPDATE an existing one in place
apply_dashboard_yaml write data:write Create a NEW dashboard from a YAML spec, or UPDATE an existing one in place.
create_dashboard write data:write Build a config-driven dashboard from a spec (the "Claude, build me a cash/AR
create_data_view write data:write Create a live, permissioned DATA view (ADR-0069) over your data tables and/or
create_table_from_file write data:import, files:read Turn a file ALREADY IN your filesystem into a queryable BotBoss table,
decompose_delta read data:read The core deterministic tool: period-A-vs-B variance attribution over the
delete_table_row write data:write Delete ONE row from a data table. The row's prior contents are kept in the
diff_warehouse_versions read data:read Why ONE record changed between two instants — per-field before/after deltas
export_table write data:read Export a data table — every column, up to 2,000 rows.
fetch_evidence read data:read Full detail for ONE ledger record you will cite (record_id =
get_artifact_refresh_schedule read data:read Read an artifact's (or dashboard-card artifact's) automatic-refresh schedule.
get_artifact_yaml read data:read Read an artifact as a clean, editable YAML spec (the agent-friendly view of
get_budget_vs_actual read data:read A budget against actuals, as GET /api/budgets/{id}/vs-actual returns it.
get_dashboard_yaml read data:read Read a dashboard as a clean, editable YAML spec (the agent-friendly view of
get_lineage read data:read Trace a data-backed artifact (chart/dashboard tile) to its metric, source
insert_table_rows write data:write Append rows to one of your data tables. Always CREATES (never de-duplicates).
list_artifacts read data:read List the artifacts YOU own (ADR-0058) — reusable, embeddable data outputs.
list_budgets read data:read List the budgets you can read, as GET /api/budgets does. Read-only.
list_dashboards read data:read List the dashboards YOU can read (the ones you own + any shared with you).
list_data_pipelines read data:read List each data pipeline (connector) and the result of its LAST sync (READ-ONLY).
list_financial_findings read data:read List your tenant's OPEN financial anomaly findings (ADR-0095), e.g. a probable
list_source_records read data:read The individual ledger rows behind one decompose_delta contributor
list_tables read data:read List the tenant's data tables you may read.
qbo_financial_statements write data:read, integrations:read Income statement for the period and balance sheet as of period_to, BUILT
qbo_tie_out read data:read, integrations:read Tie the tenant's warehouse general ledger to QuickBooks, account by account.
query_warehouse read data:read Run ONE read-only SELECT over your data tables + the tenant's QBO/Ramp
read_table read data:read Read rows of one data table or VIEW by id (use list_tables() to discover ids).
read_warehouse_as_of read data:read Rows of a warehouse relation as they stood at a past instant (ADR-0103) —
set_artifact_refresh_schedule write data:write Set (or CLEAR) an artifact's automatic-refresh schedule.
share_data_view write data:write Share a DATA view (created via create_data_view) with a person, agent, or
update_table_row write data:write Patch columns of ONE row in a data table, leaving the rest alone.
upload_file write data:write, files:write Push a file INTO the tenant's BotBoss workspace (the "Claude, put this in
verify_answer read data:read The non-skippable gate: check an answer_object for arithmetic CLOSURE

Skills

Discover, author, version, and share reusable agent playbooks.

Tool Access Scopes Summary
delete_skill write skills:write Permanently delete a skill you authored (ADR-0040).
describe_capabilities read skills:read What this workspace can do now, could do if connected, and who unlocks the rest.
get_skill read skills:read Read one skill's current body + metadata (READ-ONLY).
list_skills read skills:read List the skills you can reach in this workspace (READ-ONLY).
promote_skill_version write skills:write Restore an earlier version of a skill as its live head (ADR-0040).
propose_skill write skills:write Save what you just did as a reusable skill (ADR-0040).
read_skill_file read skills:read Read ONE reference FILE bundled with a skill, by its path (READ-ONLY).
share_skill write skills:write Deploy one of your skills to a teammate or another agent (GRANT only).
update_skill write skills:write Revise a skill you can edit (ADR-0040).

Files

Read, write, and organize files.

Tool Access Scopes Summary
list_files read files:read List the tenant's files you may read (respects file + folder grants).
read_file read files:read Read one file's metadata + a bounded text preview (use list_files() to
share_folder write files:write Share a real Files folder (and its non-private subtree + the files in it) with a
unshare_folder write files:write Revoke a principal's DIRECT grant on a real Files folder. Only YOU-with-full

People & messaging

Find people and agents, and send messages.

Tool Access Scopes Summary
active_workspace read users:read Which BotBoss workspace is THIS connection acting on? The "where am I"
invite_member write users:write Request a workspace invitation for a person — APPROVAL-GATED, never sends.
list_available_people read users:read People in your tenant's connected Slack workspace who are NOT yet BotBoss
list_organizations read users:read List the BotBoss organizations (workspaces, in the ACCOUNT sense) you belong
list_users read users:read List people the agent can assign tasks to.

Memory

Read and write an agent's long-term memory.

Tool Access Scopes Summary
add_memory write memory:write Write a memory / learning into your store (memory-over-MCP, ADR-0051).
search_memory read memory:read Search your accessible memory (memory-over-MCP, ADR-0051).

Approvals

Raise and act on approvals that gate sensitive work.

Tool Access Scopes Summary
create_action_checklist write approvals:write Propose a batch of PRE-BOUND recommended actions the human can review, tweak,
create_approval write approvals:write Raise an approval against a task.

Sharing

Share resources with people, teams, and agents.

Tool Access Scopes Summary
create_artifact write share:write Persist a hosted, shareable report artifact and get a permalink (the

Audit

Read the audit trail.

Tool Access Scopes Summary
get_history read audit:read The before→after audit diffs (B-2 history, PR #319) for one entity, oldest→

General

Capability discovery and other tools.

Tool Access Scopes Summary
send_message write — Send ONE message through a messaging gateway. APPROVAL-GATED, AND USUALLY

Other

Tool Access Scopes Summary
ask_agent write agents:invoke Ask a same-tenant hired agent a question and wait for the synchronous reply.
get_connector_refresh_schedule read integrations:read Read an ETL connector's automatic re-sync schedule.
list_destinations read channels:read List the places you can send to through one gateway — the destination
list_gateways read channels:read List every outbound messaging gateway BotBoss knows, and say honestly
list_slack_channels read channels:read List the channels in your tenant's connected Slack workspace that the
post_to_slack write channels:write Ask to post a message to a channel in your tenant's connected Slack workspace.
qbo_get_entity read integrations:read Fetch ONE entity from the tenant's LIVE QuickBooks books, in full.
qbo_get_report read integrations:read Run a LIVE QuickBooks report — trial balance, P&L, balance sheet, AR/AP ageing.
qbo_list_entities read integrations:read List entities from the tenant's LIVE QuickBooks books — not the ETL warehouse.
request_capability write integrations:read Request a connector CAPABILITY you don't yet hold, so you can do something a
resync_slack_members write channels:write Back-link your connected Slack workspace's members to BotBoss users (by
salesforce_create_sobject write integrations:write Create a record in the tenant's LIVE Salesforce org.
salesforce_describe_sobject read integrations:read Describe a Salesforce sObject's schema (field API names, types, whether each
salesforce_get_sobject read integrations:read Fetch ONE Salesforce record by sObject type + id from the LIVE org.
salesforce_soql_query read integrations:read Run a read-only SOQL query against the tenant's LIVE Salesforce org.
salesforce_update_sobject write integrations:write Update an existing record in the tenant's LIVE Salesforce org.
save_browser_download write browser:read, files:write Save a file this browser session downloaded into your durable filesystem.
send_group_message write channels:broadcast, users:read Ask to send ONE message to several people at once in your tenant's Slack.
set_connector_refresh_schedule write integrations:write Set (or CLEAR) an ETL connector's automatic re-sync schedule.
set_financial_classification write financial:write Persist a category/class correction for one entity or transaction line —
submit_request write intake:file File a bug / feature request / feedback / question into BotBoss (ADR-0119).