How to Use the FullStory MCP in Mastra AI

Q: Can Mastra AI automatically retry failed FullStory queries?

The workflow engine handles failures natively. If a getuser request times out, it applies exponential backoff and tries again. Your pipelines keep running without manual intervention.

Q: What happens if an MCP Server session export job is still processing?

You build conditional logic around the listexports response. If the state says processing, the agent waits and checks again later. It only attempts the download when the URI is ready.

Build resilient support workflows that automatically fetch and analyze FullStory sessions using Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FullStory MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Triage with Mastra AI

The `list_sessions` tool searches telemetry data based on your specific JSON criteria. The MCP Server executes this via Mastra when a high-priority ticket drops. The agent automatically pulls playback links and browser signatures before a human even looks at the issue. If the initial query fails, the framework's exponential backoff kicks in and retries. Once successful, it passes the ID to `get_session` to grab the page transitions. Your team starts debugging immediately instead of hunting for the right recording.

Manage Warehouse Ingestion

The `list_exports` tool checks the status of bulk data offloads for your warehouse. Your AI client runs this operation on a schedule. It reads the processing states and grabs the download URIs automatically. Before initiating heavy jobs, `get_account_info` verifies your workspace scope and live integration limits. Conditional branching allows the workflow to pause if API limits are close. You avoid failed jobs and wasted compute.

Inject Backend Metrics

The `create_event` tool dispatches custom backend markers directly into your analytics boundary. Mastra AI triggers this step after a complex payment workflow succeeds or fails. You bypass the frontal JavaScript client entirely to ensure accuracy. Compliance workflows use `delete_user` to erase session history when a customer exercises their right to be forgotten. You build a branch that catches deletion requests and executes the tool automatically. Human-in-the-loop approval ensures nobody deletes the wrong profile by mistake.

Setup guide

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

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

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

Initialize an MCPClient with your server URL and call listTools(). Spread those tools into your Agent configuration. The framework auto-detects whether to use Streamable HTTP or SSE.

The workflow engine handles failures natively. If a get_user request times out, it applies exponential backoff and tries again. Your pipelines keep running without manual intervention.

Set the requireToolApproval flag on sensitive operations like delete_user. The workflow pauses execution until an admin signs off. This prevents accidental data loss during automated runs.

You build conditional logic around the list_exports response. If the state says processing, the agent waits and checks again later. It only attempts the download when the URI is ready.

The integration exposes exact structural DOM changes via get_session_events. Vinkius isolates this data flow inside a zero-trust execution environment. The ephemeral sandbox destroys itself the moment the workflow completes.

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