MCP tools

The set of tools available for use through Retool's MCP.

Retool's MCP server provides access to the following tools. When you authenticate the MCP, identify the scope(s) that you want the MCP to be authorized for.

You cannot be granted a scope for more permissions than your Retool account permits. For example, only organization administrators can select the mcp:admin scope. In addition, you will only be shown objects (such as apps, resources, or workflows) that you have permission to view.

Tool	Required Scope	Description
retool_list_apps	mcp:read	List apps in the organization.
retool_get_app	mcp:read	Get a single app by app ID.
retool_list_resources	mcp:read	List resources available in the organization, including databases, APIs, storage, and AI providers.
retool_get_resource	mcp:read	Get metadata for one resource by name. Use this for resource details, not for querying the underlying data.
retool_get_resource_ts_definitions	mcp:read	Generate global variable bindings and TypeScript definitions for selected resources. Required before retool_execute_resource_ts.
retool_list_react_app_threads	mcp:read	List recently active threads for an app and return thread handles that can be used to continue work.
retool_get_react_app_thread_activity_status	mcp:read	Check whether an existing thread has active agent work, without starting a workflow or opening a stream.
retool_read_react_app_thread_stream	mcp:read	Fetch the most recent persisted chat messages for an existing thread. Reads durable history only.
retool_create_resource	mcp:write	Create a new resource. Provide the resource type plus optional connection fields, then finish configuration in the returned URL.
retool_execute_resource_ts	mcp:write	Execute a TypeScript snippet against selected resources using the bindings from retool_get_resource_ts_definitions.
retool_list_react_app_files	mcp:write	List file paths, sizes, and line counts for an app. Returns metadata only, never file contents.
retool_read_react_app_files	mcp:write	Read the contents of specific files in an app. Requires an explicit list of paths.
retool_create_or_append_react_app_thread_message	mcp:write	Create or update an app from a natural-language prompt. Omit appUuid to create a new app.
retool_tail_react_app_thread_stream	mcp:write	Monitor an active thread and forward progress updates until activity completes, needs review, or times out.
retool_respond_to_react_app_thread_review	mcp:write	Wait for a pending review request, present it to the user, and submit the response so activity can continue.
retool_cancel_react_app_thread_activity	mcp:write	Cancel activity on an active thread by sending a stop request to the sandbox agent.
retool_report_tool_usage_feedback	mcp:write	Report feedback about MCP tool usage, including helpful outcomes, unexpected behavior, or missing capabilities.
retool_list_audit_logs	mcp:admin	List audit log events in the organization.
retool_list_workflows	mcp:admin	List workflows in the organization.
retool_get_workflow	mcp:admin	Get a workflow by workflow ID.
retool_delete_workflow	mcp:admin	Delete a workflow by workflow ID.
retool_list_folders	mcp:admin	List folders in the organization.
retool_get_folder	mcp:admin	Get a folder by folder ID.
retool_list_environments	mcp:admin	List environments in the organization.
retool_get_environment	mcp:admin	Get an environment by environment ID.
retool_list_users	mcp:admin	List users in the organization.
retool_get_user	mcp:admin	Get a single user by user ID.
retool_get_organization	mcp:admin	Get organization settings.
retool_list_user_invites	mcp:admin	List user invites in the organization.
retool_get_user_invite	mcp:admin	Get a single user invite by invite ID.
retool_create_user_invite	mcp:admin	Create a user invite.
retool_delete_user_invite	mcp:admin	Delete a user invite by invite ID.
retool_set_user_invite_attribute	mcp:admin	Create or update a user attribute on a user invite.
retool_delete_user_invite_attribute	mcp:admin	Delete a user attribute from a user invite.