Skip to main content
Appenda
Sign inDownload

Tool catalog

The agents in the desktop app's Agents panel work on your tables through these 72 appenda.* tools. They aren't yet available to MCP clients outside the app; see MCP.

Start here

  1. appenda.list_tables
  2. appenda.table_profile
  3. appenda.count_rows with a filter

Read tables

ToolWhat it does
appenda.healthChecks that the app is ready for tool calls.
appenda.list_tablesLists the workspace's tables.
appenda.table_profileDescribes a table's fields, size, filter and sort, without row values.
appenda.table_query_planReads a table's active filter and sort.
appenda.table_windowReads a page of rows, with the active filter and sort applied.
appenda.search_cellsSearches for text in chosen fields.
appenda.count_rowsCounts the rows that match a filter, without returning them.
appenda.group_countsCounts rows per value of one field.
appenda.json_shapeShows the paths inside a JSON or enrichment field.
appenda.inspect_json_cellReads one JSON value as a tree of short previews.
appenda.extract_json_pathReads one path from a JSON or enrichment field across many rows.

Change rows

ToolWhat it does
appenda.insert_rowsAdds rows to a table.
appenda.update_cellsChanges values on existing rows.
appenda.delete_rowsDeletes chosen rows.
appenda.find_replaceFinds and replaces text in one field.
appenda.dedupe_rowsRemoves duplicate rows.
appenda.set_table_dedupeKeeps a table free of duplicates as new rows arrive.

Row changes show you what would change first, and only apply when the agent confirms. Changes over your role's limit need an approval.

Views

ToolWhat it does
appenda.set_active_queryChanges the filter and sort you see.
appenda.clear_active_queryClears the filter and sort.
appenda.list_viewsLists a table's saved views.
appenda.create_viewCreates a saved view.
appenda.save_viewSaves the current filter and sort to a view.
appenda.switch_viewSwitches to another view.
appenda.rename_viewRenames a view.
appenda.delete_viewDeletes a view.

Tables and fields

ToolWhat it does
appenda.create_tableCreates a table.
appenda.create_fieldAdds a field.
appenda.rename_fieldRenames a field.
appenda.delete_fieldDeletes a field.
appenda.reorder_fieldsChanges the field order.
appenda.set_field_visibilityShows or hides fields.
appenda.change_field_typeChanges a field's type and converts its values.

Formulas and run conditions

ToolWhat it does
appenda.preview_formulaTries a formula on sample rows without saving it.
appenda.create_formula_fieldCreates a formula field.
appenda.update_formula_fieldChanges a formula.
appenda.set_run_conditionSets when an enrichment field runs.
appenda.clear_run_conditionRemoves an enrichment field's run condition.

Interfaces

ToolWhat it does
appenda.list_interfacesLists interfaces.
appenda.get_interfaceReads an interface.
appenda.get_interface_schemaReads the full input of an interface tool.
appenda.preview_aggregateComputes a chart or metric without saving it.
appenda.suggest_dashboardSuggests a ready-made interface for a table.
appenda.create_interfaceCreates an interface.
appenda.update_interfaceRenames an interface or replaces its pages.
appenda.upsert_interfaceReplaces a whole interface.
appenda.delete_interfaceDeletes an interface.
appenda.add_interface_blocksAdds blocks to a page.
appenda.update_interface_blockReplaces one block.
appenda.move_interface_blockMoves a block.
appenda.delete_interface_blockDeletes a block.

Integrations and enrichment

ToolWhat it does
appenda.integration.list_providersLists providers, whether each is connected, and their actions.
appenda.integration.search_actionsFinds a provider action by what it does.
appenda.integration.get_actionReads one action's inputs and outputs.
appenda.integration.run_actionRuns one provider action, such as creating a campaign.
appenda.integration.save_http_requestSaves a reusable HTTP request.
appenda.integration.preview_enrichment_columnShows what an enrichment column would do, with no provider calls.
appenda.integration.create_enrichment_columnCreates an enrichment column.
appenda.integration.create_waterfallCreates one waterfall field that tries providers in order and stops per row at the first answer.
appenda.integration.run_enrichment_columnRuns an enrichment column.
appenda.integration.list_import_previewPreviews a list import.
appenda.integration.list_import_startStarts a previewed list import.
appenda.integration.list_import_statusReads a list import's progress.
appenda.integration.list_import_stopStops a list import.
appenda.integration.list_import_resumeResumes a paused list import.

Runs that call a provider start from a preview and need your approval before they spend anything.

Browser sign-in

Offered only while Appenda's browser is on.

ToolWhat it does
appenda.request_sign_inOpens a separate, visible browser window on a page, where you sign in yourself. The agent cannot see or use that window.
appenda.finish_sign_inCopies that window's cookies into the agent's browser, closes the window, and returns only how many were copied.

Memory

Notes you keep for your agents, in local and Cloud workspaces (Agent memory). A note saved after the agent read anything else in that turn waits for you to keep it, and is never recalled until you do.

ToolWhat it does
appenda.memory_saveSaves a short note to your memory or, for editors and above, the workspace's. Saving the same key again replaces it. At most 3 saves per turn.
appenda.memory_searchFinds the notes you kept, by words, and returns them as quoted data.

Routines

Offered in every chat, accepted only in a bot routine's own run.

ToolWhat it does
appenda.save_progressSaves where the run is (a position and a short note), so the routine's next run starts there.

Bots

Offered in every chat on the desktop. The asked bot answers in its own chat, listed under that bot, with its own tools and memory. A bot that was asked cannot ask another bot, and a chat has one question out at a time.

ToolWhat it does
appenda.list_botsLists the bots you can ask: id, name, mode and a one-line purpose.
appenda.message_botAsks one of your bots a question and returns its final answer (at most 32 KB). Send a chat_id from an earlier answer to continue that chat.

Questions

Offered in every chat and every mode on the desktop. The agent asks when it needs to clarify or recommend, and waits for your answer.

ToolWhat it does
appenda.ask_userShows you one to four questions on one card. Each has two to four options with one marked Recommended, plus Other with a text field.