How to Use the Mode Analytics MCP in Mastra AI

Q: Can I use Mastra AI to trigger a Mode Analytics report run?

Yes. You can register the runmodereport tool within your Mastra agent. The agent can trigger the run and use a workflow step to poll the status until completion.

Q: Can a Mastra AI agent audit access to my Mode Analytics spaces?

Yes. The agent can combine listmodespaces and listmodemembers to audit who has access to which spaces, then output a clean report.

Q: How do I register the Mode Analytics MCP Server in Mastra AI?

Use the MCPClient constructor from @mastra/mcp and supply the server URL. You can then list and register tools directly inside your Mastra agent configuration.

Build resilient, multi-step workflows that trigger Mode Analytics report runs and verify SQL queries using Mastra AI agents.

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 Mastra AI

Create your Vinkius account to connect Mode Analytics to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate complex reporting pipelines with Mastra AI

Mastra AI excels at multi-step agent workflows that require strict execution logic. This MCP Server lets your agent list every workspace space with `list_mode_spaces` and identify outdated reports using `list_mode_report_runs`. If a report hasn't been run today, the workflow automatically triggers a new execution. If the initial run fails, Mastra's built-in retry engine handles backoffs automatically. The agent monitors the run using `get_mode_report_run` until it succeeds, ensuring your downstream pipelines always get fresh data.

Verify SQL query definitions before execution

Avoid running expensive, broken SQL queries on your warehouse. Your Mastra AI agent can use this MCP configuration to read active query definitions using `list_mode_queries` and run them against schema definitions pulled from `list_mode_definitions`. This pre-execution check catches syntax changes or missing tables before you trigger a run. This mechanism stops bad queries from wasting compute resources. By building this validation step into your Mastra workflows, you maintain high data reliability.

Manage workspace members and spaces programmatically

Keep your analytics workspace organized without manual intervention. The agent uses `list_mode_members` to verify who has access to specific data spaces. It can cross-reference this list with your internal directory. This helps you audit permissions and ensure the right team members are assigned to the right Mode spaces.

Setup guide

Set up Mode Analytics MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Mode Analytics tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "mode-analytics-mcp-client",
  servers: {
    "mode-analytics-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Mode Analytics Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Mode Analytics tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Mode Analytics transactions"
);
console.log(result.text);

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 Mastra AI

Yes. You can register the `run_mode_report` tool within your Mastra agent. The agent can trigger the run and use a workflow step to poll the status until completion.

Mastra AI uses its built-in workflow engine to handle rate limits. If a tool like `list_mode_reports` hits a limit, the framework automatically retries the call with exponential backoff.

Yes. The agent can combine `list_mode_spaces` and `list_mode_members` to audit who has access to which spaces, then output a clean report.

Use the `MCPClient` constructor from `@mastra/mcp` and supply the server URL. You can then list and register tools directly inside your Mastra agent configuration.

Absolutely. All metadata, including member lists and space names, is processed inside an isolated, zero-trust sandbox. No credentials or workspace details are stored or logged.

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