How to Use the BattleMetrics MCP in Windsurf

Q: How does Windsurf use BattleMetrics to track live servers?

Cascade calls listservers or searchservers to pull real-time data on player counts, maps, and server status. It connects these tools to build local files or reports instantly.

Q: Can I automate ban checks using BattleMetrics in Windsurf?

Yes, Cascade chains listbans with getban to fetch specific moderation logs. It parses the ban reasons and admin IDs without requiring manual API requests.

Q: Does the BattleMetrics MCP server support player search in Windsurf?

Absolutely. Cascade runs listplayers to find a player by name, then pulls their complete history. It handles the ID lookups and session tracking automatically.

Q: How do I configure this MCP server in my workspace?

Open your Windsurf settings and add the server to your mcpconfig.json file. Cascade detects the tools instantly and integrates them into its autonomous workflow.

Let Cascade track game servers, audit player histories, and pull ban lists autonomously inside your Windsurf workspace.

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 Windsurf

Create your Vinkius account to connect BattleMetrics to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-monitor game servers with Windsurf

The `list_servers` tool lets Cascade pull real-time server directories without you typing a single query. Windsurf chains this data directly with `get_server` to extract active player counts, server ranks, and IP addresses. You specify the game, and Cascade maps the entire server ecosystem. It handles the pagination behind the scenes so you get a complete picture instantly.

Deep Player Profile Investigations

The `list_players` tool acts as your starting point to locate specific users across thousands of tracked servers. Your agent grabs the player ID, then runs `get_player` and `get_player_sessions` in sequence to map out their exact play habits. Cascade doesn't stop at raw data. It analyzes session durations and server connections, then formats a clean timeline of player activity right in your editor.

Execute Instant Ban Verifications

The `list_bans` tool fetches active bans across your entire gaming organization directly inside your IDE. Cascade uses this tool to check active restrictions, then triggers `get_ban` to pull the precise admin notes and expiry dates. This setup lets you audit moderation actions without leaving your coding environment. You get the full paper trail of any player penalty with a single prompt.

Setup guide

Set up BattleMetrics MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the BattleMetrics MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my BattleMetrics payment history." If connected, Cascade will call the BattleMetrics tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "battlemetrics-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

Cascade calls `list_servers` or `search_servers` to pull real-time data on player counts, maps, and server status. It connects these tools to build local files or reports instantly.

Yes, Cascade chains `list_bans` with `get_ban` to fetch specific moderation logs. It parses the ban reasons and admin IDs without requiring manual API requests.

Absolutely. Cascade runs `list_players` to find a player by name, then pulls their complete history. It handles the ID lookups and session tracking automatically.

Open your Windsurf settings and add the server to your `mcp_config.json` file. Cascade detects the tools instantly and integrates them into its autonomous workflow.

Your API token and the retrieved player session logs remain entirely local to your Windsurf runtime. Vinkius runs the server in a secure sandbox, ensuring no external party can intercept your server queries or ban records.

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