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). |