# Mode (Collaborative Data Platform) MCP

> Mode (Collaborative Data Platform) connects your agent directly to Mode Analytics, giving you full conversational control over enterprise business intelligence. You can audit data sources, list every managed report, explore organizational spaces, and find specific analytical parameters without clicking through dashboards.

## Overview
- **Category:** brain-trust
- **Price:** Free
- **Tags:** sql-query, data-visualization, python-analytics, r-language, business-intelligence, data-reporting

## Description

Stop manually digging into complex BI platforms just to get a quick answer. This MCP connects your agent directly to Mode Analytics, letting you manage all of your organization's reporting assets using plain conversation. You can ask your agent to list every report in the workspace or audit exactly which database connectors are available for querying. Need to know what data lives in a specific team's section? Your agent explores those organizational spaces for you. It’s about taking full control of where and how your company tracks its numbers, turning complex SQL reporting into a simple conversation. Connecting this MCP through Vinkius means all your enterprise intelligence tools live under one roof, accessible by any compatible client. You get to manage data reports, explore different departmental boundaries, and track down source schemas without ever leaving your agent interface.

## Tools

### list_reports
Lists all static data reports that have been generated in your Mode workspace.

### get_report
Retrieves specific analytical parameters for a single, targeted report token.

### list_spaces
Lists all accessible 'Spaces' that isolate different datasets across your Mode workspace.

### get_space
Retrieves parameters for an explicitly targeted, defined collection Space.

### list_data_sources
Lists every explicit database or warehouse connector source bound to your Mode account.

### search_reports
Searches all reports across the workspace, evaluating queries against the live Mode API using keywords.

### list_members
Lists all statically tracked analytical users who have been joined within your current workspace.

## Prompt Examples

**Prompt:** 
```
List all reports in my 'Shared' space
```

**Response:** 
```
I've retrieved the reports from your 'Shared' space. Highlights include 'Daily Revenue Tracker' (Token: rep-123), 'User Cohort Analysis' (Token: rep-456), and 'Active Subscriptions' (Token: rep-789). Would you like to see the chart definitions for the revenue tracker?
```

**Prompt:** 
```
Search for any reports related to 'Marketing ROI' in the workspace
```

**Response:** 
```
Searching reports… I've identified 2 analytical entities: 1) Report 'Q1 Marketing ROI Summary' (Token: rep-987), and 2) Report 'Channel Specific ROI Breakdown' (Token: rep-654). Which one would you like me to fetch the detailed configuration for?
```

**Prompt:** 
```
Show me the data sources currently connected to our Mode account
```

**Response:** 
```
I've identified 3 active data sources: 'Snowflake-Prod' (Type: snowflake), 'Postgres-Analytics' (Type: postgres), and 'BigQuery-Warehouse'. I can provide the mapped schema identifiers for any of these sources if you'd like.
```

## Capabilities

### List and audit all managed reports
Retrieve a comprehensive list of every static data report generated in the Mode workspace.

### Search reports by keyword or metadata
Run a workspace-wide search to find specific reports or datasets based on keywords, even if you don't know their exact name.

### Explore organizational data spaces
Navigate and list defined 'Spaces,' which isolate datasets and help you pinpoint the correct analytical boundary for your query.

### Audit connected data sources
Enumerate all explicit databases and warehouse connectors bound to your Mode account, letting you know exactly what schemas are available.

### Inspect report configuration details
Deep dive into specific reports or spaces to retrieve precise configuration definitions and chart parameters instantly.

### List tracked users in the workspace
Verify ownership boundaries by listing all statically tracked analytical users within your current workspace.

## Use Cases

### Auditing data access for compliance
A security officer needs to know exactly what sources are exposed. They ask their agent, 'Show me all connected databases.' The agent uses `list_data_sources` and returns a list of every warehouse connector name and type.

### Finding an old performance metric
A business user needs the Q3 churn rate report but can't remember where it is. They ask their agent to search for 'Q3 Churn.' The agent uses `search_reports` and returns a list of matching reports, including the necessary tokens.

### Onboarding a new data team member
A manager needs to verify which users have access. They ask their agent to 'List all workspace members.' The agent uses `list_members` and provides a verified list of analytical user accounts.

### Investigating report scope confusion
An analyst is unsure if the data in a shared report comes from the correct department. They ask their agent to 'List all organizational spaces,' allowing them to verify the intended scope before querying.

## Benefits

- Stop clicking through menus. You can ask your agent to list all managed data reports using the `list_reports` tool, getting a complete inventory in one go.
- Pinpoint exact datasets quickly. The agent uses `search_reports` so you don't have to know the name of the report you need; just describe it.
- Verify your connections instantly. Use `list_data_sources` to see every single database and warehouse connector attached, giving immediate visibility into available schemas.
- Understand organizational boundaries. By running `list_spaces`, you can map out how different teams segment their data within the larger Mode structure.
- Get deep detail without the UI. Instead of guessing a report token, use `get_report` to pull precise configuration details and chart definitions directly into your chat session.

## How It Works

The bottom line is you get an agent that talks directly to Mode Analytics, letting you manage and query your business intelligence assets through natural language.

1. Subscribe to this MCP and provide your Mode Workspace Name, Access Token, and Access Secret.
2. Connect your agent client (like Claude or Cursor) to the Vinkius catalog and authorize access using your credentials.
3. Start by asking a conversational question like, 'What data sources are connected?' or 'List all reports in the Marketing space.'

## Frequently Asked Questions

**How do I use Mode (Collaborative Data Platform) MCP to find a specific dataset?**
Use the `search_reports` tool. You can search across the workspace using keywords or metadata descriptions, so you don't need the exact report name.

**Can Mode (Collaborative Data Platform) MCP list all available databases?**
Yes, use `list_data_sources`. This tool enumerates every explicit database and warehouse connector connected to your account.

**What is the difference between listing reports and searching them with Mode (Collaborative Data Platform) MCP?**
`list_reports` gives you a static inventory of all generated reports. `search_reports`, however, runs an evaluation against your queries to find reports matching specific keywords.

**Does the Mode (Collaborative Data Platform) MCP help me check user permissions?**
You can check ownership and boundaries by running `list_members` or by listing spaces via `list_spaces`, which shows who has access to what areas.

**What if I want details on one report? Should I use `get_report`?**
Yes, if you have a specific report token, running `get_report` is the best way. It pulls precise configuration and chart definition details for that single asset.