AI agents

MCP tool reference

These are the tools a connected agent can call. Tools marked write change data; inside a project they follow the project’s autonomy level and are recorded in the agent activity log.

Databases

Tool Type Description
list_databases read Databases of the workspace.
create_database write Create a database.
list_tables read Tables of a database.
get_table_schema read Fields of a table with their types and options.
create_table, update_table, delete_table write Manage tables.
create_fields, update_fields, delete_fields write Manage fields.
list_table_rows read Read rows, with search and paging.
create_rows, update_rows, delete_rows write Manage rows in bulk.

Projects and schema

Tool Type Description
list_projects read Projects of the workspace.
create_project write Create a project and optionally attach databases.
get_project_schema read All tables and fields of the project’s databases.
schema_diff read Compare a desired schema with the current one. Never writes.
apply_schema write Create or change tables and fields to match a desired schema, in one atomic step.
records_query read Filter, search, group and aggregate records with the query language.

Declarative schemas

schema_diff and apply_schema take the schema you want:

{
  "database_name": "Sales",
  "tables": [
    {
      "name": "Companies",
      "fields": [
        { "name": "Name", "type": "text" },
        { "name": "Country", "type": "single_select",
          "select_options": [{ "value": "US" }, { "value": "DE" }] }
      ]
    },
    {
      "name": "Deals",
      "fields": [
        { "name": "Title", "type": "text" },
        { "name": "Amount", "type": "number", "number_decimal_places": 2 },
        { "name": "Company", "type": "link_row", "link_row_table": "Companies" }
      ]
    }
  ]
}

The plan lists every operation first. Tables are never deleted and fields are only deleted with delete_missing_fields. Applying the same schema twice does nothing the second time.

Memory

Tool Type Description
get_project_context read The project briefing: decisions, assumptions, facts, summaries, documents, reports and relevant memories.
search_project_memory read Semantic (or text) search in memory.
remember write Add a memory entry.
update_memory write Change an entry.
forget_memory write Delete an entry.

Reports

Tool Type Description
list_reports read Reports of a project.
create_report, update_report write Manage report definitions.
render_report read Compute a report (or preview an unsaved definition).
snapshot_report write Freeze the current data.
publish_report write Publish with an access mode; returns public_url.

Applications, dashboards and automations

Tool Type Description
Builder tools write Create applications, pages, elements, data sources and workflow actions.
publish_application write Publish an application on a subdomain or custom domain.
create_dashboard_widget write Add a summary or chart widget and configure its data.
list_dashboard_widgets read Widgets of a dashboard.
Automation tools write Create workflows, triggers and action nodes.
publish_workflow write Make a workflow live.

Agent actions

Tool Type Description
get_agent_action read Status of an action that is waiting for approval, so the agent can follow up after you approve or reject it.

Errors

Expected problems (an unknown field, a table outside the project, an invalid report) come back as {"error": "..."} results that the agent can read and correct, instead of failing the whole call.