How to Use the BattleMetrics MCP in Vercel AI SDK

Q: How do I search for active servers using BattleMetrics in my Vercel AI SDK app?

You call the searchservers tool with your specific filter parameters. This sends a request to the server and returns the matching results for your UI to render.

Q: Can I show player history with BattleMetrics and Vercel AI SDK?

Yes, use getplayersessions to pull the raw duration and join data. You then pass this output to your client-side charts.

Q: Does this MCP Server support pagination for large datasets?

Every list-based tool, such as listservers or listplayers, accepts a pagenumber argument. You iterate through the results by incrementing this value in your calls.

Stream real-time BattleMetrics data directly into your Vercel AI SDK frontends for live player and server monitoring.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BattleMetrics MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live player and server analytics for Vercel AI SDK

Feed live server states directly into your components using `get_server` or `search_servers`. Your UI reacts instantly as the data streams back from the endpoint. Stop waiting for spinners. Use `get_server_player_count_history` to graph population trends in real-time, giving your users a clear look at server traffic without the lag.

Player lookup and session tracking

Pull detailed player profiles using `get_player` to show stats, identifiers, and activity levels. It's the fastest way to get raw data into your React or Next.js dashboard. Audit history with `get_player_sessions` to see exactly when someone joined or left a match. You get the timestamps you need to display precise session logs right in the browser.

Automated ban and ecosystem monitoring

Check organization-wide bans through `list_bans` and `get_ban` to keep your community safe. It connects your app to the source of truth for all player restrictions. Keep track of the broader gaming landscape with `list_games` and `get_game`. You'll have the metadata needed to filter and display only the relevant stats for your specific gaming community.

Setup guide

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

You call the `search_servers` tool with your specific filter parameters. This sends a request to the server and returns the matching results for your UI to render.

Yes, use `get_player_sessions` to pull the raw duration and join data. You then pass this output to your client-side charts.

Vinkius handles the connection through an ephemeral sandbox. Your API token is isolated, ensuring that only the specific data you request is fetched.

Every list-based tool, such as `list_servers` or `list_players`, accepts a page_number argument. You iterate through the results by incrementing this value in your calls.

We only access public identifiers and session metadata provided by the API. The system treats your tokens as temporary, with no persistent storage of your credentials.

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