Skip to main content

Supported Tools

ToolJet MCP exposes 73 tools to your AI client. You never call these by name: you describe what you want in plain language, and your agent selects the tools it needs. This page is a reference for what your agent is able to do once connected.

For what these add up to in practice, see the Overview. To connect a client, see Setup.

Workspace and Users​

ToolWhat it does
list_workspacesLists the workspaces your account belongs to.
use_workspaceConfirms which workspace the connection is acting on.
list_workspace_appsLists the apps in your workspace.
list_workspace_usersLists the users in your workspace, with search, filtering, and pagination.
manage_workspace_usersInvites a user, updates their name, role, or group assignments, and archives or unarchives them.
list_workspace_groupsLists the workspace's groups, a group's members, its permissions and access rules, and the apps, modules, workflows, and data sources a rule can cover. Requires admin permissions.
manage_workspace_groupsCreates, renames, duplicates, and deletes custom groups, removes a member from a group, and changes a group's permissions and access rules.

Apps and Pages​

ToolWhat it does
create_appCreates a new app with its first version and home page.
get_app_summaryReturns a bounded summary of an app's structure. This is the usual way an agent inspects an app.
get_appReturns the complete app definition, including every page and component.
get_app_settingsReads the app-wide settings on the current editing version.
update_app_settingsUpdates app-wide visual settings, such as the theme applied to an app.
add_pagesAdds one or more pages to an app.
update_pagesRenames pages, updates their sidebar metadata, or changes their order.
delete_pageDeletes a page and the components on it.

App Versions​

ToolWhat it does
list_app_versionsLists an app's versions and environments.
create_app_versionCreates a new draft version by copying an existing version, then opens it in the editor.
update_app_versionRenames a version or edits its description.
delete_app_versionDeletes a version that isn't released and opens another version in the editor. It never deletes the released or only version.
switch_app_versionOpens another version in the editor, so the agent's next changes go to that version. It doesn't release anything.
switch_app_environmentOpens the same version in another environment without promoting or releasing it.
promote_app_versionPromotes a version to staging or production. It doesn't release the app.
release_appReleases a specific version so it becomes the app's live version, promoting it through environments first when the workspace requires it.

Components and Layout​

ToolWhat it does
get_component_catalogLists the components available in ToolJet and the properties each one accepts.
add_componentsPlaces one or more components on a page.
add_component_batchesPlaces complete sets of components across several pages at once.
get_componentReturns the current configuration of a single placed component.
update_componentsEdits placed components in place, changing only the properties named.
update_layoutMoves and resizes components without changing their properties.
delete_componentsRemoves components from a page.
generate_form_schemaBuilds a ready-to-place Form from an existing ToolJet DB table.
generate_edit_contractPrepares the field defaults, change events, and save payload for a form that edits an existing record, so only changed fields are sent.

Data Sources and Queries​

ToolWhat it does
list_datasourcesLists the datasources connected to your workspace.
test_datasource_connectionRuns ToolJet's own connection test against a connected datasource.
inspect_datasource_schemaReads metadata from a connected datasource, such as its schemas and tables.
get_datasource_query_schemaReturns the request format a given datasource operation expects.
prepare_sql_discovery_queriesDrafts read-only SQL for exploring a SQL datasource, without creating or running it.
add_queriesCreates one or more queries against any connected datasource.
update_queryChanges an existing query.
delete_queryDeletes a query.
run_queryRuns an existing query and returns its result.
run_queriesRuns up to ten existing queries at once and returns their results.

ToolJet Database​

ToolWhat it does
list_tablesLists the ToolJet DB tables in your workspace.
get_table_schemaReturns a table's columns, constraints, defaults, and foreign-key relationships.
create_tablesCreates one or more ToolJet DB tables.
add_table_columnAdds a column to an existing table.
drop_table_columnRemoves a column and its stored values.
drop_tableDeletes a table and all of its rows.
insert_rows_batchAdds rows to one or more tables, so a new app has data to show.

Events and Interactivity​

ToolWhat it does
add_eventsWires behavior to a component, query, or page, such as running a query on click or showing a notification.
list_eventsLists the event handlers on an app.
update_eventsChanges existing event handlers.
delete_eventRemoves an event handler.
add_query_lifecyclesSets up standard success and failure behavior for queries, such as refreshing a table after a record is saved.

Validation​

ToolWhat it does
lint_app_specDry-runs a planned set of changes and reports problems before anything is written.
apply_app_phaseApplies a set of changes that lint_app_spec has already validated.
validate_appChecks a saved app's structure and query configuration without running anything.
verify_page_renderRenders one page or every page of a built app in a headless browser and reports empty text, placeholder values such as undefined, clipped text, and overlapping components.
get_runtime_infoReports the version of the MCP server you are connected to.

Permissions​

ToolWhat it does
manage_app_permissionsInspects, sets, or clears who can access a specific page, query, or component within an app.

Themes​

ToolWhat it does
list_app_themesLists the themes available in your workspace.
manage_themeCreates, updates, or removes workspace themes.

Workflows​

ToolWhat it does
list_workflowsLists the workflows in your workspace.
create_workflowCreates a new, empty workflow. It doesn't run or publish it, or set up triggers.
get_workflowReturns a workflow's nodes, connections, and query settings.
get_workflow_node_catalogLists the workflow node types the agent can add and the settings each one takes.
get_workflow_capabilitiesLists the node types available for a workflow version and which connected data sources can be used as queries, AI models, or email.
lint_workflow_specChecks a planned set of workflow changes without saving or running anything.
apply_workflow_specApplies workflow changes that lint_workflow_spec has already validated. It doesn't run or publish the workflow.
validate_workflowChecks a saved workflow's structure without running it.
delete_workflow_nodeRemoves a node and its connections from a workflow.
run_workflowRuns a workflow version in a selected environment, with real effects such as writes to your data sources.
get_workflow_executionReturns the status of a workflow run and the results of its nodes.

Tools That Require Confirmation​

Six tools permanently delete data and cannot run unless your agent passes an explicit confirmation. In practice this means your agent asks you before using them, rather than deciding on its own:

  • delete_page
  • delete_query
  • delete_components
  • delete_app_version
  • drop_table
  • drop_table_column

These tools also need an explicit confirmation: release_app, promote_app_version, manage_workspace_users, manage_workspace_groups, manage_app_permissions when it sets or clears access, and manage_theme when it deletes a theme.

note

Confirmation protects against accidental deletion, not against a request you made deliberately. If you ask your agent to drop a table, it will ask once and then do it.