How to Use the Fathom Analytics MCP in Vercel AI SDK

Stream real-time traffic data directly into your frontend with the Fathom Analytics MCP Server and Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Fathom Analytics MCP to Vercel AI SDK

Create your Vinkius account to connect Fathom Analytics 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.

GDPR Free for Subscribers

Setup Fathom Analytics with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live visitor monitoring in your UI

Stop refreshing dashboards to see who is on your site. The `get_current_visitors` tool pipes live counts straight into your stream, allowing your UI to update without a single page reload. Your users get an instant pulse on site activity. By mapping this to your React or Next.js components, you turn raw numbers into a live-updating status board that feels fast and responsive.

Analyze traffic trends with your AI client

Feed historical data into your agent to spot growth patterns. Use `get_pageviews` and `get_visitors` to feed the model the exact context it needs to generate summaries or reports. This keeps your data local to the request flow. You avoid the bloat of traditional analytics platforms by pulling only the specific metrics you need for your dashboard view.

Map your site inventory automatically

Let your agent manage your tracking setup by querying your account structure. The `list_sites` and `get_site` tools let your application auto-discover domains and metadata for dynamic reporting. This is how you build multi-tenant analytics tools. You define the logic once, and the server handles the discovery of every site connected to your Fathom Analytics account.

Setup guide

Set up Fathom Analytics MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with 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 Fathom Analytics tools. Pass them directly to generateText() or streamText() — 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.

index.ts

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 Fathom Analytics transactions",
});

console.log(text);
await mcpClient.close();

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 Fathom 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 Fathom 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 Fathom Analytics MCP in Vercel AI SDK

You initialize the client with your endpoint and pass the tools to your streamText function. The SDK handles the transport, allowing tool results to flow into your UI components as they arrive.

Yes, you configure an authProvider within your MCP client setup. This ensures your connection to Fathom Analytics remains secure while you stream data into your application.

Fathom Analytics processes data without tracking cookies or storing personal identifiers. Your agent only accesses the aggregate metrics you explicitly request, keeping user data off-limits.

It does. Because the SDK is built for streaming, you can trigger a tool call to get current visitor counts and push those updates to the user immediately.

Errors are caught at the tool execution layer. You can handle these in your frontend code to show an empty state or a retry prompt without crashing the stream.

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