How to Use the GoatCounter MCP in Vercel AI SDK

Stream real-time visitor stats into your Vercel AI SDK interface without the loading spinners or privacy-invasive tracking.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GoatCounter MCP to Vercel AI SDK

Create your Vinkius account to connect GoatCounter 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 GoatCounter with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live traffic monitoring with AI SDK

Feed your UI live analytics by calling `get_stats_total` directly through your generation pipeline. The AI client pulls the numbers and renders them as the data arrives. This keeps your React or Next.js dashboard reactive. You stop waiting for heavy background jobs to finish before showing the user what happened on their site.

Manage your analytics via MCP Server

Update site configurations or pull granular data using `update_site` and `get_stats_page_detail` inside your edge functions. Your AI client handles the API calls while you focus on the frontend logic. Everything stays within your control. You aren't sending private logs to third-party ad networks just to see how many people hit your page.

Automated data exports for your app

Trigger `start_export` and `download_export` to pull historical logs into your application state. Your agent manages the lifecycle of the request from initiation to file retrieval. It works reliably over HTTP transport. You get the raw data you need for custom visualizations without leaving your development environment.

Setup guide

Set up GoatCounter 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 GoatCounter 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 GoatCounter 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 GoatCounter. 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 GoatCounter 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 GoatCounter MCP in Vercel AI SDK

Install the MCP client package and point it to your server endpoint. You then pass the tool list directly into your generateText call. It connects in seconds.

Yes. Since the MCP server communicates via HTTP, your stream remains uninterrupted. The agent resolves the tools and pushes results to your UI in real time.

Absolutely. You can script an agent to fetch stats every morning. The agent uses the provided tools to compile the data and draft a summary for you.

The server uses your API key to authenticate every request. No data is stored on Vinkius infrastructure, keeping your stats between you and your analytics provider.

No. The server only touches aggregate pageview and referral counts. It does not track individual users, so your application stays compliant by default.

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