# Retool MCP Connector MCP

> Retool MCP lets your AI agent inspect and audit internal applications directly. Instantly review who has access, what databases are connected, and how your entire suite of custom tools is structured—all from a simple chat prompt.

## Overview
- **Category:** superpower
- **Price:** Free
- **Tags:** internal-tools, app-building, database-management, audit-logs, workflow-monitoring, low-code

## Description

Connect your conversational assistant to the Retool ecosystem for deep infrastructure insights. This connector allows your AI to look inside the complex web of internal applications built in Retool. You can ask it to map out your organizational structure, checking every tool and folder available without clicking through dozens of dashboards. Need to know who has access? Your agent reads the user list and checks current permission groups against those users. Want to audit what data powers your apps? It lists all connected databases and APIs for you. This ability to inspect infrastructure status—whether it's a PostgreSQL database or an external Stripe API—and monitor background automation tasks is incredibly powerful. Vinkius makes this whole catalog available, letting you connect once and instantly gaining the power to audit internal systems from any MCP-compatible client.

## Tools

### get_app
Retrieves detailed information about one specific Retool application by name or ID.

### list_apps
Provides a complete list of every custom application available in the Retool organization.

### list_folders
Shows you the folder hierarchy used to organize tools within the Retool workspace.

### list_groups
Retrieves a list of all existing permission groups that control user access rights.

### list_resources
Lists every data source, API connector, or external service wired into the Retool platform.

### list_users
Generates a comprehensive list of all currently active users in your Retool organization.

### list_workflows
Shows the status and names of all automated background tasks running in Retool.

## Prompt Examples

**Prompt:** 
```
List all users in my Retool workspace.
```

**Response:** 
```
I invoked `list_users` successfully. I found 8 users in your organization, including `alice@example.com` and `bob@example.com`. Let me know if you need to know their group assignments using the associated permission tools.
```

**Prompt:** 
```
List all applications currently configured.
```

**Response:** 
```
Running `list_apps`, I retrieved a total of 12 distinct internal tools within your environment. Popular examples include your 'Admin Dashboard', 'Customer Refund Portal', and 'Inventory Tracker'. Would you like the detailed properties for a specific one?
```

**Prompt:** 
```
Tell me what resources are connected to our Retool.
```

**Response:** 
```
By querying `list_resources`, I can see 5 integrated services in your Retool account. This includes your production 'PostgreSQL Database', a 'Stripe API' connector, and an 'S3 Bucket' for file uploads. The connections are confirmed active.
```

## Capabilities

### Audit application structure
Lists all existing apps and folders in your Retool workspace so you can map out how tools are organized.

### Check user permissions
Retrieves the list of organization members and audits which permission groups they belong to.

### Review connected data sources
Lists every database, API, or external service wired into your Retool operational stack.

### Monitor system workflows
Checks for active background automation tasks and processes running within the environment.

## Use Cases

### The database connection mystery
A data team member needs to confirm if the new regional PostgreSQL database is connected. Instead of logging into Retool and clicking through settings, they just prompt their agent: "Are all required databases available?" The agent runs `list_resources` and confirms the connection status immediately.

### Onboarding a new team
An IT admin needs to check what access rights Bob has. Rather than trying to find his profile, they ask the agent: "What groups is Bob in?" The agent calls `list_users` and then cross-references permissions using `list_groups`, giving an instant answer.

### Pre-launch infrastructure check
An engineering lead needs to verify if the payment module can process transactions. They ask the agent: "Show me all connected APIs and workflows." The agent runs `list_resources` and `list_workflows`, confirming both Stripe API connectivity and active automation tasks.

### Understanding app sprawl
A manager wants to know which internal tools exist. They ask the agent: "What apps are built?" The agent responds with a list from `list_apps`, giving them a complete inventory of assets they never knew existed.

## Benefits

- Pinpoint access issues instantly. Instead of clicking through user menus, ask the agent to list all users and check their group assignments using `list_users` and `list_groups` for a quick audit.
- Verify data connectivity in seconds. The `list_resources` tool lets you confirm if critical systems, like your PostgreSQL database or Stripe API, are actually wired into Retool when you need to know it.
- Map the entire application landscape. Use `list_apps`, and then follow up with `list_folders` and `get_app` to understand how every single internal tool is organized without any manual navigation.
- Check automation health easily. If a workflow fails, use `list_workflows` to list all active background tasks and see if anything unexpected has stopped running.
- Reduce risk during handoffs. When onboarding new staff or changing roles, you can run an audit combining user listing, group checking, and resource review all in one chat session.

## How It Works

The bottom line is you can use chat to run complex audits that used to require hours of manual clicking through multiple dashboards.

1. Install the Retool module into your MCP environment and securely provide your Retool Access Token and Domain.
2. Your AI client receives permission to query the internal structure of your applications, users, and resources within Retool.
3. You simply ask a natural language question like, "List all active users and tell me what databases are connected," and get an immediate audit report.

## Frequently Asked Questions

**How do I use Retool MCP to check user access?**
You simply ask the agent to list users and groups. It automatically uses `list_users` to get member names, then runs `list_groups` to show which permission sets those members belong to.

**Can I check if my database is connected using Retool MCP?**
Yes, use the agent to run `list_resources`. This tool checks every API and data source wired into Retool, confirming if your PostgreSQL or Stripe connections are active.

**Does Retool MCP only list apps, or can it show me details?**
It does both. You can start by listing all applications with `list_apps`, and then drill down into a specific app's properties using the `get_app` tool.

**How do I find out what background tasks are running?**
Ask the agent to check workflows. It uses the `list_workflows` tool to provide an overview of all automated background processes in your Retool environment.