How to Use the FullStory MCP in Vercel AI SDK
Stream FullStory session data directly into your Next.js frontend using the Vercel AI SDK.
Works with every AI agent you already use
…and any MCP-compatible client
Connect FullStory MCP to Vercel AI SDK
Create your Vinkius account to connect FullStory to Vercel AI SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.
Stream Session Data with Vercel AI SDK
The `get_session` tool pulls page transitions and active time directly into your React components. Your AI client fetches the metadata while the user watches the UI update. You don't need a loading spinner. The data just appears on screen as the edge function resolves the request. Combine that with `get_session_events` to render click trails and DOM changes in real-time. You pass the session ID. The Vercel AI SDK streams the chronological telemetry straight to the browser. Support reps get immediate visual context without leaving your custom dashboard.
Sync Custom Tenant Data Live
The `create_update_user` tool pushes CRM attributes into the FullStory analytics boundary. Next.js server actions handle the form submission, and your agent upserts the identity instantly. Cross-device interaction boundaries update without a page refresh. When support needs background context, `get_user` retrieves the raw behavior history. The MCP Server streams total session durations and custom variables directly to your frontend. You keep support agents in your app instead of forcing them to open another tab.
Query Analytics Boundaries
The `list_segments` tool resolves saved audience definitions and 30-day population counts. Your Vue or Svelte frontend requests a specific cohort. The MCP Server executes the query and pipes the logical filter structures back to the client. Drill down further using `list_users` to expose individual session counts and behavioral profiles. You define the query criteria. The edge function streams the resulting visitor directory straight into your custom data tables.
Set up FullStory MCP in Vercel AI SDK
Prerequisites
- Node.js 18+ and a TypeScript project
-
ai+@modelcontextprotocol/sdkpackages - Active Vinkius subscription with a valid endpoint token
- 1
Install dependencies
Run
npm install ai @modelcontextprotocol/sdkplus your preferred model provider (e.g.@ai-sdk/openai). - 2
Create the Streamable HTTP transport
Use
StreamableHTTPClientTransportwith your Vinkius endpoint URL. Replace[YOUR_TOKEN_HERE]with your token from cloud.vinkius.com. - 3
Discover and use tools
Call
mcpClient.tools()to auto-discover all FullStory tools. Pass them directly togenerateText()orstreamText()— no manual schema definitions needed. - 4
Works with any model provider
Swap
openai("gpt-4o")for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.
import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
const transport = new StreamableHTTPClientTransport(
new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);
const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "List recent FullStory transactions",
});
console.log(text);
await mcpClient.close(); 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.
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 Vercel AI SDK
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the FullStory MCP today
We host it, we monitor it, we maintain it. You just paste one token.