Mode Analytics MCP. Manage reports and audit SQL queries from chat.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Mode Analytics MCP Server lets your AI agent take full control of complex data workflows. Instead of manually navigating workspaces, listing reports, or running SQL queries in a web interface, you talk to your data directly.
Your agent can list spaces and members, trigger report runs with custom parameters (using 'run_mode_report'), audit underlying SQL code ('list_mode_queries'), and check field definitions—all through natural conversation.
What your AI agents can do
Get mode account
Retrieves basic details for the authenticated Mode Analytics account.
Get mode report
Fetches detailed metadata for a single, specific report within your workspace.
Get mode report run
Gets the current status and history of a particular executed report run.
Get a list of all available spaces and members in the Mode Analytics account.
Retrieve metadata for specific reports, including their associated parameters and run status.
Start a new report calculation by triggering a run, supporting custom inputs for the report template.
View and understand the raw SQL queries used within any given report.
List calculated field definitions to verify that metrics are being computed consistently across reports.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
Mode Analytics MCP Server: 10 Tools for Data Mastery
These tools give your AI client full access to Mode's API, letting it manage workspaces, run reports, and audit all underlying data definitions.
019d75d6get mode account
Retrieves basic details for the authenticated Mode Analytics account.
019d75d6get mode report
Fetches detailed metadata for a single, specific report within your workspace.
019d75d6get mode report run
Gets the current status and history of a particular executed report run.
019d75d6list mode definitions
Provides a list of all calculated field definitions used across your reports, ensuring metric consistency.
019d75d6list mode members
Lists every user member belonging to the Mode Analytics workspace.
019d75d6list mode queries
Retrieves and lists all underlying SQL queries associated with a given report's definition.
019d75d6list mode report runs
Lists the history of executed reports for a specific report ID, showing status and timestamps.
019d75d6list mode reports
Finds and lists all available reports within a specified Mode Analytics space.
019d75d6list mode spaces
Lists every individual data workspace (or 'space') available in your account.
019d75d6run mode report
Initiates a new report run using defined parameters, triggering the necessary data computation.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Mode Analytics, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
This MCP Server lets your AI agent take full control of Mode Analytics workflows, letting you talk to your data instead of clicking through dashboards. You'll never have to manually navigate workspaces or run queries in a web interface again; your agent handles it all via natural conversation.
get_mode_account: Retrieves the basic details for the authenticated Mode Analytics account, so your agent knows exactly which workspace you're dealing with.
list_mode_spaces: Lists every individual data workspace—or 'space'—available in your account. You can use this tool to inventory all the different areas where your team keeps its analysis and reports.
list_mode_members: Provides a list of every user member belonging to the Mode Analytics workspace, letting you check who has access to what data.
list_mode_reports: Finds and lists all available reports within a specified space. You can point your agent to a specific area and get a catalog of everything that's ready for review or execution.
get_mode_report: Fetches detailed metadata for a single, specific report in your workspace. This includes checking the report's parameters and understanding its current status without having to open it up manually.
list_mode_definitions: Gives you a list of all calculated field definitions used across your reports. You use this tool to verify that metrics are being computed consistently everywhere, which is crucial for making sure everyone's using the same numbers.
When auditing data pipelines and understanding exactly what code drives your reports, list_mode_queries retrieves and lists all underlying SQL queries associated with a given report’s definition. This lets you see the raw logic—the exact SQL—so you know where every number is actually coming from.
For checking how far along a specific run is, get_mode_report_run gets the current status and history of a particular executed report run. If you need to check the overall timeline for a single report ID, list_mode_report_runs lists the entire history of executed reports for that ID, showing the status changes and timestamps.
If you're ready to compute something new or rerun an old analysis, run_mode_report starts a brand-new report run using defined parameters. This tool triggers the necessary data computation on the fly, letting your agent support custom inputs right when it executes.
Your AI client can also use these functions in conjunction with get_mode_report and list_mode_reports. You'll tell your agent which space you want to work in, then ask it to list all reports there. Once the report is identified, the agent pulls its specific metadata so you know what parameters are needed before running it.
If those parameters change, or if someone modifies the underlying SQL logic—which list_mode_queries shows—your agent keeps you informed.
The combination of these tools means your AI client can manage everything from initial discovery and user auditing to complex execution and deep code inspection. You're not just reading data; you're running the whole engine.
How Mode Analytics MCP Works
- 1 First, subscribe to the server and input your Mode API Token, API Secret, and Workspace slug into the client environment.
- 2 Next, tell your agent exactly what you need—for example: 'List all reports in the Marketing space' or 'Run the Campaign ROI report with Q3 data'.
- 3 The agent uses the available tools (like
list_mode_reportsorrun_mode_report) to talk to Mode Analytics and returns the required data, status updates, or findings.
The bottom line is that your AI client becomes a proxy for your entire analytics platform, letting you manage complex data tasks with simple chat prompts.
Who Is Mode Analytics MCP For?
This server is built for people who spend too much time clicking through dashboards just to get one number. If you're tired of switching between your BI tool and a terminal to check an API, this is for you. It’s for the technical user who needs deep data visibility without leaving their chat window.
You use list_mode_queries when you need to quickly audit an existing report's SQL logic, or you call get_mode_report just to verify a specific metric’s input parameters.
You monitor the entire workspace using tools like list_mode_members and track overall activity by listing reports across spaces, keeping governance in check.
When a campaign launches, you use run_mode_report to trigger updated data runs instantly from your chat interface, getting the results without manual intervention.
What Changes When You Connect
- Stop guessing about report status. Use
list_mode_report_runsorget_mode_report_runto see the current state of any data pipeline without logging into the web app. - Need to check if 'Profit Margin' is calculated the same way everywhere? Call
list_mode_definitionsonce, and you get a clear list of every defined metric across your workspace. - Forget manually copying report IDs. The agent handles it: just tell it to run the report, and it uses
run_mode_report, passing required parameters automatically. - Don't trust the visual dashboard alone. Use
list_mode_queriesto pull up the raw SQL behind any chart, letting you verify data lineage instantly. - Need a quick overview of who has access? Call
list_mode_membersto get an immediate list of all users in your analytics environment.
Real-World Use Cases
The quarterly audit:
A BI Manager needs to know if the 'Q3 Revenue' report used the correct definition for Gross Sales. Instead of clicking through settings, they ask their agent. The agent runs list_mode_definitions and confirms that the calculation matches the standard template, solving a potential data inconsistency issue.
Campaign performance check:
A Growth Lead wants to see the latest numbers for 'Leads by Channel' right after a campaign ends. They prompt their agent to run_mode_report using the specific report token and pass today's date as a parameter, getting real-time data without delay.
Debugging stale reports:
A Data Analyst suspects a key dashboard is showing old numbers. They use list_mode_reports to find the report ID, then call get_mode_report_run to see if the last run failed or if it's overdue, immediately identifying the pipeline failure.
Onboarding new team members:
A manager needs an overview of who can access data. Instead of asking IT for a list, they ask their agent to list_mode_members. The agent provides a clean roster, letting the manager immediately see all current users in the workspace.
The Tradeoffs
Assuming simple listing is enough
A user just asks: 'Show me my reports.' This vague prompt leaves out context (like which space) and may return too much noise, making it useless.
→
Be specific. Use list_mode_reports and specify the exact space name or report ID you're interested in. Always narrow the scope.
Not checking query logic
A dashboard looks wrong, but the user assumes it must be a data source issue. They waste time debugging external databases.
→
First, call list_mode_queries on that report. Check the underlying SQL to see if the calculation itself is flawed or missing necessary joins.
Ignoring run status
A user triggers a report run and then assumes it's finished, only to find the dashboard hasn't updated because the job failed silently.
→
After calling run_mode_report, immediately follow up by calling get_mode_report_run to check the status. Wait until you see 'Success' before trusting the data.
When It Fits, When It Doesn't
Use this server if your core problem is controlling, auditing, or executing complex analytical workflows within Mode Analytics. You need visibility into report definitions (list_mode_definitions), the underlying SQL code (list_mode_queries), and the ability to trigger fresh data runs on demand (run_mode_report). Don't use this if you only need basic chat conversation; your AI client can handle that without connecting to Mode. Also, don't rely solely on it for governance—while list_mode_members helps, actual access control still lives within the Mode platform itself.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mode Analytics. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking data status used to require logging into a dashboard and clicking three separate tabs.
Remember when you had to navigate to the report in the web UI, then check the 'Run History' tab for its status? If it was old, you’d have to go back to the main page, find the run parameters, and manually trigger a new calculation. It’s clicks, copy-pasting, and switching context.
Now, your agent handles it all. You simply tell it: 'Check the latest status for Campaign ROI.' The server calls `get_mode_report_run` and gives you the current state—failed, queued, or done—right in your chat window.
Mode Analytics MCP Server helps you manage data via conversation.
Previously, understanding a report's logic meant digging into the 'Query Details' panel and reading raw SQL. If you needed to know if a specific field was calculated correctly, you had to find the definition list in another tab, which wasn't always visible.
Now, your agent calls `list_mode_queries` for the code audit, and separately calls `list_mode_definitions` for the metric rules. You get both pieces of context—the 'how' and the 'what'—in one smooth workflow.
Common Questions About Mode Analytics MCP
How do I list all available reports using list_mode_reports? +
You tell your agent to use list_mode_reports. You can narrow the search by specifying which space you want to look in, making sure you only get relevant report metadata.
Can I trigger a new run using run_mode_report? +
Yes. To use run_mode_report, you must provide the report ID and any required custom parameters (like dates or campaign tokens) so the calculation runs with fresh data.
What is the difference between list_mode_reports and get_mode_report? +
Use list_mode_reports when you want to see a full directory of every report in a space. Use get_mode_report when you already know which specific report ID you need details on.
I found an error, how do I check the SQL query using list_mode_queries? +
Pass the target report's ID to list_mode_queries. The server will return the underlying SELECT statement and any JOIN logic used in that report.
How do I verify my connection credentials using get_mode_account? +
It returns your authenticated account details. This tool confirms that the API token and workspace slug are correctly set up, letting your agent know it has permission to interact with your data.
What is the first step if I need to see all available workspaces? Should I use list_mode_spaces? +
Yes, you use list_mode_spaces. This tool retrieves every analytical space you have access to. It gives your agent a full map of where reports and data live within Mode.
How do I check the detailed status of a single report execution using get_mode_report_run? +
It provides granular details on one specific run. You get key information like start time, end status, and any custom parameters used for that particular job.
What is the purpose of running list_mode_definitions? +
This tool lists all calculated field definitions. It confirms how metrics are mathematically derived across your workspace, which helps you spot data inconsistency errors before they appear in a report.
How do I find my API Token and Secret? +
In Mode, click on your name in the top left, go to My Account > API Tokens. There you can create and manage your API keys.
What is the Workspace slug? +
The Workspace slug is the unique identifier for your organization in the Mode URL (e.g., app.mode.com/org_name). The org_name part is your workspace slug.
Can I provide parameters when running a report? +
Yes! The run_mode_report action accepts an optional parameters field where you can provide a JSON string of keys and values used by the report.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Bloomberg Law
Access 200M+ court dockets, case law, and legal news via Bloomberg Law Enterprise Dockets API for comprehensive legal research.
Atlan
Search and discover data assets, business glossaries, classifications, policies, and personas directly via your AI agent.
Alation
Data catalog orchestration — search assets, audit metadata, and query data via AI.
You might also like
DISQO
Equip your AI agent to manage consumer insight projects, track audiences, and monitor behavioral metrics via the DISQO API.
Cosmic
Manage headless content via Cosmic — list and create objects, audit schema types, handle media assets, and manage buckets directly from any AI agent.
Slack
Manage channels, users, and send messages on Slack with AI agents.