# ThoughtSpot MCP

> ThoughtSpot connects your entire analytics environment to your chat client. You can ask your agent questions about your data—like listing all dashboards or checking user permissions—without opening a single tab. It lets you search through metadata, browse visualizations, and verify backend connections instantly.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** data-visualization, natural-language-query, metadata-search, analytics, business-insights, liveboards

## Description

Connect this MCP to any AI-compatible client and bring your complex analytics workflow directly into the chat window. Stop juggling tabs just to find out what data exists or who has access. This tool lets you treat your entire BI infrastructure like a searchable database of information.

Need to see if Snowflake is connected? Just ask, and it verifies that for you. Want to check which user groups exist across departments? It lists them up. You can search through all the underlying metadata—Liveboards, Answers, or Logical Tables—and get immediate answers about your data assets. Everything you need to know about your organization's reports and configurations is available right here through Vinkius, making it a single source of truth for your BI stack.

## Tools

### search_metadata
Finds specific data objects, like liveboards or logical tables, by searching through the system's metadata using a defined type.

### list_liveboards
Provides an exhaustive list of every available Liveboard (dashboard) connected to your account.

### list_answers
Generates a comprehensive list of all saved Answers, which are individual charts or data tables.

### list_account_users
Retrieves and displays the full directory of users registered within your ThoughtSpot instance.

### list_user_groups
Lists all logical groups established in the system, helping you map out user access structures.

### list_data_connections
Shows a list of configured data source connections (like Snowflake or BigQuery) that power your platform.

### list_metadata_tags
Retrieves all metadata tags used for classifying and categorizing various reports and data objects in the system.

## Prompt Examples

**Prompt:** 
```
Show me a list of all active database connections.
```

**Response:** 
```
I found 2 data connections active on your ThoughtSpot instance:
- Connection ID: 6223-bd7-snow, Name: 'Snowflake Production Warehouse'
- Connection ID: 4422-bc5-aws, Name: 'AWS Redshift Archival'
```

**Prompt:** 
```
Can you list all the user groups configured?
```

**Response:** 
```
Your ThoughtSpot environment currently has 4 logical groups:
1. 'Administrators'
2. 'Finance Viewers'
3. 'Marketing Edit'
4. 'All Users'
```

## Capabilities

### Search analytical assets by type
The agent searches the metadata system to find specific data objects like dashboards or charts.

### Browse available visualizations
It lists all existing Liveboards (dashboards) and individual Answers (charts/tables) so you know what reports are ready to use.

### Check user permissions and groups
The system retrieves details on registered account users, user groups, and their current access levels.

### Verify data source connections
It lists all configured backend database connections, such as Snowflake or BigQuery, proving which sources are live.

### Review data classification tags
You can view the metadata tags used across your organization to classify and organize reports and data objects.

## Use Cases

### Checking connectivity before a meeting
A Data Engineer needs to confirm if the production Snowflake connection is up and running for a major presentation. Instead of logging into the UI, they ask their agent, which calls `list_data_connections`, getting an instant confirmation of the active source.

### Onboarding new team members
An IT Admin needs to know exactly who has access and what groups exist. They use the MCP to run `list_user_groups` and `list_account_users`, getting a clean, structured list of everyone and every group for immediate review.

### Auditing data ownership
An Analytics Manager needs to know which departments own certain report types. They use the MCP's ability to check metadata tags via `list_metadata_tags` to map out the organization’s classification system.

### Discovering forgotten reports
A user can't find a specific dashboard and suspects it exists. They use `search_metadata`, specifying 'LIVEBOARD', which quickly returns links or names for assets they didn't know existed.

## Benefits

- Skip manual navigation. You can list all available Liveboards using `list_liveboards` instantly, avoiding the tedious process of clicking through dozens of dashboard folders.
- Verify data source health in seconds. Use `list_data_connections` to confirm if Snowflake or BigQuery are active without opening a single admin tab.
- Know your users at a glance. Running `list_account_users` gives you the full roster, while `list_user_groups` defines how those people are organized and what permissions they hold.
- Pinpoint data assets fast. Instead of browsing everything, use `search_metadata` to hunt for specific types of reports or tables across the entire organization.
- Understand your taxonomy. Quickly review all metadata tags using `list_metadata_tags` so you know how the company classifies every piece of data.

## How It Works

The bottom line is, instead of clicking through multiple admin tabs, you talk directly to your entire analytics infrastructure and get answers back in plain text.

1. Subscribe to this MCP, providing your ThoughtSpot Cloud Host URL, Username, and Secret Key.
2. Your agent uses those credentials to establish a live connection to your BI system's metadata layer.
3. You simply ask the agent questions—like 'Which databases are connected?'—and it returns the structured data you need.

## Frequently Asked Questions

**How does ThoughtSpot MCP list all available dashboards?**
You use the `list_liveboards` tool. This command pulls an exhaustive list of every Liveboard connected to your account, letting you see them all in one go.

**Can I check database connectivity with ThoughtSpot MCP?**
Yes, run `list_data_connections`. The agent lists all configured data source connections (like Snowflake or BigQuery) and tells you which ones are active on your platform.

**Does ThoughtSpot MCP help me find specific reports?**
You use the `search_metadata` tool. You can search for assets by type, whether it's a Liveboard or an Answer, making discovery much faster than manual browsing.

**What if I want to see who is in which user group?**
First run `list_user_groups` to get the list of groups. Then you can use `list_account_users` to verify specific users and their current access levels.

**Is ThoughtSpot MCP only for viewing metadata?**
No, it's designed to query your entire BI infrastructure’s metadata. You get details about user groups, data connections, tags, and visualizations—it’s a comprehensive status check.