How to Use the Mode Analytics MCP in Windsurf

Q: How does Windsurf run a Mode Analytics report without manual intervention?

Cascade uses the runmodereport tool to trigger an API-level execution. It then automatically chains getmodereportrun in a loop to verify when the data is ready for consumption.

Q: Can Cascade fetch raw SQL queries using this Mode Analytics MCP Server?

Yes, Cascade calls listmodequeries to pull the exact SQL statements from your reports. It parses the SQL to understand your database schema and write accurate local code.

Q: How do I configure the Mode Analytics MCP Server inside Windsurf?

Open your local config file at /.codeium/windsurf/mcpconfig.json and add the server configuration under the mcpServers block. Alternatively, use the Settings UI to register the connection.

Q: What happens if a report run fails during a Cascade workflow?

Cascade catches the failure state returned by getmodereportrun and stops the chain. It reads the error metadata to explain exactly what broke in your SQL or connection.

Get live Mode Analytics data directly in Windsurf as Cascade chains queries, runs reports, and builds dashboards autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mode Analytics MCP to Windsurf

Create your Vinkius account to connect Mode Analytics to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Mode Analytics with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Trigger and track report runs in Windsurf

The `run_mode_report` tool, exposed through this MCP Server, lets Cascade queue up fresh data updates without you clicking around the Mode UI. Once fired, Cascade uses `get_mode_report_run` to monitor the execution status until the run completes. You get clean, updated datasets right inside your workspace. Cascade handles the polling loop in the background, freeing you up to write your frontend code or analyze the output.

Discover spaces and reports via this MCP Server

The `list_mode_spaces` tool fetches your entire workspace hierarchy so your AI agent knows exactly where your SQL assets live. After finding the right space, the agent runs `list_mode_reports` to catalog every available dataset. This eliminates manual searching through browser tabs. Cascade maps out the data structure of your Mode Analytics project, letting you reference reports by name instead of digging for raw API IDs.

Inspect SQL definitions and queries directly

The `list_mode_queries` tool extracts the underlying SQL code directly from your specified Mode report. To make sense of custom business logic, the agent calls `list_mode_definitions` to pull calculated field formulas. You see the exact logic feeding your charts. Cascade reads these SQL structures to write matching local database queries or verify data lineage before you commit code.

Setup guide

Set up Mode Analytics MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Mode Analytics MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Mode Analytics payment history." If connected, Cascade will call the Mode Analytics tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "mode-analytics-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Mode Analytics now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Mode Analytics MCP in Windsurf

Cascade uses the `run_mode_report` tool to trigger an API-level execution. It then automatically chains `get_mode_report_run` in a loop to verify when the data is ready for consumption.

Yes, Cascade calls `list_mode_queries` to pull the exact SQL statements from your reports. It parses the SQL to understand your database schema and write accurate local code.

Open your local config file at `~/.codeium/windsurf/mcp_config.json` and add the server configuration under the `mcpServers` block. Alternatively, use the Settings UI to register the connection.

Cascade catches the failure state returned by `get_mode_report_run` and stops the chain. It reads the error metadata to explain exactly what broke in your SQL or connection.

No, Windsurf never stores your raw database credentials. This integration only passes metadata, SQL queries, and run statuses through secure, ephemeral V8 sandboxes that self-destruct after execution.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript