# ThoughtSpot MCP for AI Agents AI Agent Connect

> ThoughtSpot MCP lets you query your business intelligence metadata directly through your AI agent. Instead of hunting through menus, you can ask your agent to find specific Liveboards, check user permissions, or see which data sources like Snowflake are connected. It turns your BI infrastructure into a searchable knowledge base for your team.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_pXyGMZhQjuyYVL1C9M2o8DFmnyosszih2upUPJ6R/ai-agent-connect
- **Tags:** data-visualization, natural-language-query, metadata-search, analytics, business-insights, liveboards

## Description

This Connector lets you pull your ThoughtSpot metadata directly into your AI agent's workspace. Instead of clicking through layers of menus to find a specific dashboard or checking permissions manually, you can just ask your agent to do the digging. It handles the heavy lifting of navigating your organization's analytics assets, whether you're looking for a specific dashboard, searching for saved charts, or checking which data sources like Snowflake are active. You can also use it to audit your user groups or see how your team uses tags to organize reports. It's a big shift in how you interact with your business intelligence stack, moving away from manual UI navigation toward a searchable, conversational interface. You can find this in the Vinkius catalog to get your team's data workflows moving faster.

## Tools

### list_user_groups
See all the user groups and their distributions. Use this to check how different departments are organized in your system.

### list_data_connections
Find out which data sources like Snowflake or BigQuery are currently connected. This helps you verify your backend infrastructure in one go.

### search_metadata
Search for specific metadata objects in ThoughtSpot by type. This helps you find exactly what you need without browsing through folders.

### list_liveboards
Get a full list of all available dashboards in your ThoughtSpot instance. It's a quick way to see what visualizations are already built.

### list_answers
See all saved individual charts or tables across your environment. This makes it easy to find specific data points that have already been captured.

### list_account_users
Retrieve a list of every user registered in your ThoughtSpot account. This is perfect for auditing who has access to your analytics.

### list_metadata_tags
List all the tags your team uses to classify data objects and reports. It helps you understand the organizational logic of your data.

## Prompt Examples

**Prompt:** 
```
Who has access to our Finance group?
```

**Response:** 
```
I've pulled the user group details for you. The 'Finance' group currently contains the following 4 members:

| Name | Role | Status |
| :--- | :--- | :--- |
| **Alex Chen** | Finance Lead | Active |
| **Sarah Miller** | Analyst | Active |
| **Jordan Smit** | Manager | Active |
| **Taylor Reed** | Auditor | Active |
```

**Prompt:** 
```
What data sources are we using?
```

**Response:** 
```
Your ThoughtSpot instance is currently connected to the following data sources:

*   **Snowflake Production** (Primary Warehouse)
*   **BigQuery Marketing_Data** (Cloud Storage)
*   **AWS Redshift Archival** (Legacy Data)
```

**Prompt:** 
```
Are there any Liveboards for the marketing team?
```

**Response:** 
```
I found 3 Liveboards related to marketing:

1.  **Q4 Marketing Spend** (Liveboard)
2.  **Social Media Engagement** (Liveboard)
3.  **Campaign ROI Tracker** (Liveboard)
```

## Capabilities

### Find specific Liveboards or Answers
Search your analytics assets by type to find exactly what you need.

### Check active database connections
See which data sources like Snowflake or BigQuery are currently connected.

### Audit user groups and memberships
Retrieve lists of registered users and see how they are organized into groups.

### Search for metadata tags
Look up the tags your team uses to classify different data objects.

### Browse your visualization library
Get a full list of all available dashboards and charts in your environment.

## Use Cases

### Auditing user access for security
A security admin needs to audit who has access to the finance group. They ask the agent to list user groups and then check the specific members.

### Verifying backend data sources
A data engineer wants to verify if the BigQuery connection is active. They ask the agent to list data connections to see the status of all sources.

### Finding reports by organization tags
A manager needs to find all reports tagged as 'Q3 Results'. They ask the agent to search metadata for those specific tags.

### Checking for existing visualizations
An analyst wants to see if a specific chart already exists before building a new one. They use list_answers to see all saved charts.

## Benefits

- Stop digging through menus to find dashboards. Use list_liveboards to see everything at once in a single list.
- Check your data source health faster. Use list_data_connections to see active Snowflake or BigQuery links without opening the settings page.
- Audit your team's access in seconds. Use list_account_users and list_user_groups to see who's in what group instantly.
- Find specific reports instantly. Use search_metadata to filter by Liveboards, Answers, or Logical Tables based on your needs.
- Organize your workspace better. Use list_metadata_tags to see how your team classifies different data objects and reports.

## How It Works

The bottom line is you get a searchable, chat-based interface for your entire ThoughtSpot metadata library.

1. Subscribe to the ThoughtSpot MCP on Vinkius.
2. Provide your ThoughtSpot Cloud Host URL, Username, and Secret Key.
3. Ask your agent to find reports, check users, or list data sources.

## Frequently Asked Questions

**Can I find specific ThoughtSpot reports using an AI agent?**
Yes. You can ask your agent to search for specific reports by name, type, or tags. It will scan your metadata and return the relevant Liveboards or Answers instantly.

**How do I check ThoughtSpot user groups with this Connector?**
You can ask the agent to list your user groups at any time. It will provide a breakdown of all groups and their memberships to help you audit permissions quickly.

**Can I see my Snowflake connections in ThoughtSpot via AI?**
Yes. The agent can list all configured data connections, including Snowflake, BigQuery, and others, so you can verify your backend setup without logging into the admin console.

**How does ThoughtSpot MCP help with metadata searching?**
It turns your entire ThoughtSpot environment into a searchable knowledge base. Instead of manual browsing, you can use natural language to find specific assets across your organization.

**Can I list all ThoughtSpot Liveboards using this tool?**
Absolutely. You can ask the agent to list all available Liveboards to see every dashboard your team has built in one single view.

**Does ThoughtSpot MCP show me my organization's data tags?**
Yes, it can list all the tags your team uses to classify data objects. This helps you understand how your reports and data are organized across the platform.

**Where do I get my ThoughtSpot Secret Key?**
You can find or generate your Secret Key in the ThoughtSpot instances under the **Develop** menu, inside the **Security settings** (specifically Trusted Authentication). Note that you need admin tracking rights or developer privileges to enable this type of access.

**Can the AI modify my dashboards?**
No. The integration exclusively lists and searches metadata elements (Liveboards, Data connections, Answers, Users). It will not modify, overwrite, or delete any configurations or data objects.

**What types of metadata can I search for?**
Liveboards (dashboards), Answers (individual charts and tables), Logical Tables, data source connections, users, user groups, and organizational tags.