Skip to main content

Use MCP to inspect workflows

You can connect to Retool's MCP server directly from your coding environment. Retool's MCP enables you to build apps from your chosen development environment, import React apps into Retool, inspect and debug workflows, and manage your organization's settings and users.

note

The MCP server provides access to Retool functionality in an external environment. This functionality is distinct from the MCP resource, which lets you connect third-party tools and services as a native integration in classic apps, workflows, and agents.

Refer to the MCP tool reference for the full list of tools.

Use cases​

The following use cases are examples of what can be accomplished using the MCP server:

Use the MCP server to inspect and debug workflows. With it, your agent can read a workflow's:

  • Blocks and connections.
  • Run history and logs to find out why a run failed.
  • Triggers and their configuration.
Reconnect MCP client after enabling the beta

To use these read-only tools, contact your Retool account team to enable them for your organization. After they're enabled, reconnect your MCP client so it refreshes its list of tools. You only see workflows that you have permission to view.

The Workflows MCP tools have the following limitations:

  • The MCP server doesn't return some block settings, such as REST pagination and OpenAPI settings.
  • Run logs return the newest 200 lines by default, and up to 1,000 lines with the limit parameter. Very long lines can reduce the number of lines returned.

For a full list of available tools, refer to the MCP tools reference, or install the MCP server and run tools/list.

Connect MCP server​

You can connect Retool's MCP server to an MCP-compatible client using the following details:

  • URL: https://mcp.retool.com/mcp
  • Transport: HTTP
  • Authentication: OAuth 2.0

Once you authenticate your MCP server with OAuth 2.0, you may have to restart your coding agent.

Common coding agents​

The following examples show how to connect to the MCP server with common coding agents.

To configure the MCP server as a tool for use in Retool Agents, complete the following steps:

  1. Navigate to the Resources tab in Retool. Click Create new > Resource, and select MCP Server.
  2. Configure the resource:
    1. Title: Retool MCP
    2. Description: An MCP server for interacting with Retool.
    3. Server URL: https://mcp.retool.com/mcp
    4. Authentication: Automatic
    5. Click Auto-configure authentication.
    6. Scroll down and click Connect with OAuth. Click Authenticate.
    7. Enter your organization URL and click Continue, or choose an organization that you are already logged into.
    8. Select the scopes that you want the MCP to have access to. Click Authorize.
  3. Navigate to a new or existing agent and add a new tool.
    1. Click Add new tool.
    2. Select Connect to MCP server.
    3. From the dropdown, select the MCP server you created in the previous step.
    4. Click Save.
  4. Test out your agent from the Chat tab.

Credit usage​

For app-building tasks, the MCP server engages two agentic services:

  • Your local development agent decides what to build, and passes your prompt to Retool.
  • Retool's app building agent works to create or update your app.

Each of these services charges separately for their portion of the work. In Retool, if you utilize Retool-managed keys, any app building consumes AI credits. If your organization is on the Enterprise plan and you bring your own key, app building does not consume AI credits.

Refer to the AI monitoringAI visibility page for visibility into credit consumption and the AI spend controls page for instructions on setting AI credit usage limits for enterprise organizations.

No AI credits are consumed for workflow inspection, admin, or resource exploration tasks.