# Mode MCP for AI Agents AI Agent Connect

> Mode (Collaborative Data Platform) MCP connects your AI agent to your Mode Analytics account. It lets you manage reports, explore organizational spaces, and audit data sources through natural language. Instead of clicking through dashboards, you can ask your agent to find specific reports, check chart configurations, or list active database connectors.

## Overview
- **Category:** brain-trust
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Ir1DkTkXUOZ1DX9dDLLFHnh4Dztuz00MXlUCaLT9/ai-agent-connect
- **Tags:** sql-query, data-visualization, python-analytics, r-language, business-intelligence, data-reporting

## Description

This Connector gives your AI agent a direct line into your Mode Analytics workspace. Instead of jumping between tabs to find a specific report or trying to remember which database is connected to which dashboard, you can just ask your agent to do the heavy lifting. You can have your agent find specific reports based on keywords, pull up the exact configuration for a chart, or map out which data sources are currently active in your account. It handles the navigation of complex spaces so you don't have to hunt for report tokens manually. If you're trying to audit who has access to what or need to see the underlying query states for a shared report, this tool makes that data instantly accessible. It's a way to turn your enterprise business intelligence into a searchable, actionable knowledge base. You can find this and thousands of other integrations on the Vinkius catalog to keep your data workflows moving without the usual friction.

## Tools

### list_spaces
See all accessible Spaces that isolate datasets across your Mode workspace. This helps you understand how your data is organized.

### get_space
Get the parameters mapping a specific collection Space. Use this to understand the scoped analytical boundaries of a shared area.

### list_data_sources
See all database and warehouse connectors bound to your Mode account. It helps you quickly identify which schemas are available for querying.

### search_reports
Find specific reports by searching against literal metadata and keywords. It saves you from manual navigation when looking for a specific dataset.

### list_members
Get a list of all statically tracked analytical users in your workspace. Use this to verify report ownership and collaborative boundaries.

### list_reports
Pull a list of all static data reports generated in your workspace. This is the first step for auditing your entire report library.

### get_report
Retrieve specific analytical parameters and chart definitions for a single report token. It gives you the exact configuration details you need.

## Prompt Examples

**Prompt:** 
```
Show me all the reports in the Shared space.
```

**Response:** 
```
I've retrieved the reports from your 'Shared' space. Highlights include:

| Report Name | Token |
| :--- | :--- |
| Daily Revenue Tracker | rep-123 |
| User Cohort Analysis | rep-456 |
| Active Subscriptions | rep-789 |

Would you like to see the chart definitions for the revenue tracker?
```

**Prompt:** 
```
What data sources are connected to our Mode account?
```

**Response:** 
```
I've identified 3 active data sources currently bound to your Mode account:

* **Snowflake-Prod** (Type: snowflake)
* **Postgres-Analytics** (Type: postgres)
* **BigQuery-Warehouse** (Type: bigquery)

I can provide the mapped schema identifiers for any of these sources if you'd like.
```

**Prompt:** 
```
Find any reports related to Marketing ROI.
```

**Response:** 
```
Searching reports... I've identified 2 analytical entities:

1. **Q1 Marketing ROI Summary** (Token: rep-987)
2. **Channel Specific ROI Breakdown** (Token: rep-654)

Which one would you like me to fetch the detailed configuration for?
```

## Capabilities

### Find specific reports using keyword searches
Ask your agent to locate reports based on literal metadata or keywords.

### Pull detailed chart configurations
Retrieve exact analytical parameters and query states for specific reports.

### Map out active database connectors
See every database and warehouse source bound to your Mode account.

### Navigate between personal and shared spaces
Explore different organizational boundaries and isolated datasets easily.

### Identify tracked workspace members
Verify which analytical users are joined within your workspace.

### Retrieve report tokens for scoped queries
Get the exact tokens needed to query specific analytical boundaries.

## Use Cases

### Finding a specific report
An analyst needs a marketing report but doesn't know the name. They ask the agent to search for "Marketing ROI" using search_reports.

### Auditing connectors
An engineer needs to know which databases are active. They ask the agent to list all sources using list_data_sources.

### Checking configurations
A user wants to know how a specific chart is built. They ask the agent to get the parameters for a specific report token using get_report.

### Space navigation
A new hire wants to see what's in the Shared space. They ask the agent to list all spaces and then list reports in a specific one.

## Benefits

- Stop hunting for report links. Use search_reports to find exactly what you need in seconds without clicking through folders.
- Audit your data sources instantly. Use list_data_sources to see every warehouse connector and schema bound to your account.
- Get exact chart details. Use get_report to pull specific analytical parameters and configurations without opening the web UI.
- Map your workspace structure. Use list_spaces and get_space to understand how your organization isolates different datasets.
- Verify user permissions. Use list_members to check who is tracked in your workspace and ensure collaborative boundaries are secure.

## How It Works

The bottom line is you get instant, conversational access to your Mode Analytics metadata and report structures.

1. Subscribe to the Mode MCP on Vinkius.
2. Enter your Mode Workspace Name, Access Token, and Access Secret.
3. Ask your AI client to list reports, search for data, or audit your sources.

## Frequently Asked Questions

**Can the Mode MCP find reports for me?**
Yes, it can search your entire workspace for specific reports using keywords or metadata descriptions. This lets you find exactly what you need without clicking through folders.

**How does the Mode MCP help with data audits?**
It lets you list all connected database and warehouse sources so you can see exactly what's bound to your account. This is great for keeping your data architecture organized.

**Can I use the Mode MCP to see chart configurations?**
Yes, it can retrieve specific analytical parameters and chart definitions for any report you have. This helps you understand how your data is being visualized.

**Does the Mode MCP support private spaces?**
It can list and navigate accessible spaces, including personal and shared organizational boundaries. You can explore how your data is isolated across the workspace.

**Can the Mode MCP identify workspace members?**
It can list the statically tracked analytical users joined within your Mode workspace. This helps you verify report ownership and collaborative boundaries.

**Is the Mode MCP good for analytics engineers?**
It's great for monitoring warehouse connectors and managing space hierarchies across multiple environments efficiently. It saves you from manual navigation and repetitive audit tasks.

**Can I see the chart configurations for a specific Mode report through my agent?**
Yes. Use the `get_report` tool with a specific Report Token. Your agent will retrieve the detailed analytical parameters, exposing the chart configurations and the underlying query logic used to generate the report data.

**How do I check which databases are currently linked to my Mode workspace?**
The `list_data_sources` tool retrieves all database and warehouse connectors bound to your account. Your agent will report the source names and mapped schemas, helping you identify which data is available for SQL reporting.

**Can my agent help me find specific reports across different organizational spaces?**
Absolutely. Use the `search_reports` tool with a search query. Your agent will filter through the metadata of all reports across your workspace, helping you locate critical data insights instantly without manual navigation.