How to Use the OpenPanel MCP in Mastra AI

Q: How can I ensure an OpenPanel event is always tracked in a Mastra AI workflow?

Use the trackevent tool within a Mastra AI step that has automatic retries configured. If the initial API call to the OpenPanel MCP server fails, Mastra will handle re-sending it until it succeeds.

Q: Can my Mastra AI agent perform different actions based on an OpenPanel user profile?

Yes. First, use the identifyuser tool to get the user's context. Then, your Mastra AI workflow can use conditional logic based on the user's properties in OpenPanel to execute different tasks.

Q: What's the best way to manage API credits in OpenPanel with a Mastra AI agent?

Use the decrementproperty tool. You can build a workflow step that tries to decrement the credit count. If the call fails or the count is zero, Mastra's engine can redirect the flow to a 'purchase more credits' task.

Q: How do I get started with the OpenPanel tools in Mastra AI?

Install @mastra/mcp and instantiate the MCPClient with your Vinkius server URL. Call mcpClient.listTools() and spread the result into your agent's tool configuration. Mastra handles the transport automatically.

Build resilient analytics workflows for Mastra AI. Automatically retry failed events and tie user tracking into complex, multi-step agent tasks.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect OpenPanel MCP to Mastra AI

Create your Vinkius account to connect OpenPanel to Mastra AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup OpenPanel with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Make Analytics Calls Fault-Tolerant

The `track_event` tool sends user activity to OpenPanel. The real advantage with Mastra AI is what happens if that call fails. Instead of losing data, Mastra's workflow engine can automatically retry the call with exponential backoff. This makes your analytics just as reliable as your core business logic. You can build a workflow where a failed `track_event` call triggers a fallback, like logging the event to a different system, ensuring you never miss a beat.

Tie User Identity to Workflows

Start your agent workflow by calling `identify_user`. This establishes the user's context in OpenPanel for the entire duration of the Mastra AI task, even if it runs for hours or across multiple steps. Then, use Mastra's conditional logic to branch your workflow based on user properties. For example, if a user is identified as a 'premium' member, route them to one task; if not, route them to another. This MCP server provides the data, Mastra provides the logic.

Reliably Update User State with this MCP Server

The `increment_property` and `decrement_property` tools are atomic operations. When your Mastra agent needs to change a numeric value—like a usage counter—it's a single, reliable tool call. Combine this with Mastra's workflow engine. For example, you can build a task that attempts to `decrement_property` for a feature credit. If the call succeeds, the agent proceeds; if it fails, the agent can branch to an upsell flow.

Setup guide

Set up OpenPanel 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 OpenPanel 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: "openpanel-mcp-client",
  servers: {
    "openpanel-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent OpenPanel 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 OpenPanel. 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 OpenPanel 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 OpenPanel MCP in Mastra AI

Use the `track_event` tool within a Mastra AI step that has automatic retries configured. If the initial API call to the OpenPanel MCP server fails, Mastra will handle re-sending it until it succeeds.

Yes. First, use the `identify_user` tool to get the user's context. Then, your Mastra AI workflow can use conditional logic based on the user's properties in OpenPanel to execute different tasks.

Use the `decrement_property` tool. You can build a workflow step that tries to decrement the credit count. If the call fails or the count is zero, Mastra's engine can redirect the flow to a 'purchase more credits' task.

Install `@mastra/mcp` and instantiate the `MCPClient` with your Vinkius server URL. Call `mcpClient.listTools()` and spread the result into your agent's tool configuration. Mastra handles the transport automatically.

Your Mastra agent sends user traits and event properties to the Vinkius-managed MCP server. That server, authenticated by your token, forwards the data to OpenPanel over a secure connection. No data is stored on the Vinkius server itself.

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