How to Use the BattleMetrics MCP in Cursor

Q: Can Cursor write Discord bots using BattleMetrics data?

Yes, the agent calls getban to see exactly how the penalty data is structured. It then writes the Discord bot command using that exact JSON schema.

Inject live BattleMetrics player counts and server metadata straight into your codebase using the BattleMetrics MCP Server and Cursor Agent mode.

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 Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build server dashboards in Cursor

`get_server` hands your editor the exact JSON structure for a game server's live IP, rank, and status. Cursor writes your React frontend components using real data so it doesn't guess what the API response looks like. Writing chart logic gets much easier when `get_server_player_count_history` feeds actual population timestamps into your workspace. The MCP client maps the historical data directly into your charting library without you needing to mock a single array.

Code leaderboard features with live data

`get_server_leaderboard` pulls active player names and playtime durations straight into your editor. You tell the agent to build a ranking table, and it uses the live IDs to generate accurate TypeScript interfaces. Expanding those profiles happens through `get_player`, which fetches linked Steam identifiers and recent activity. The editor writes the profile rendering logic while looking at a real player's time played statistics.

Query game ecosystems via MCP Server

`list_games` gives your codebase the official game IDs and display names required for building dropdown menus. The agent drops the exact metadata into your constants file so your filter components work on the first try. Implementing complex search requires knowing the parameters, which `search_servers` demonstrates by returning granular country and rank filters. The IDE sees the exact filter syntax and writes the corresponding API wrapper functions for you.

Setup guide

Set up BattleMetrics MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the BattleMetrics MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent BattleMetrics transactions." If the MCP tools are loaded correctly, Cursor will call the BattleMetrics tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

Create an mcp.json file inside your .cursor directory at the project root. Paste the server command details there, and Agent mode will pick up the tools immediately.

Yes, the agent calls `get_ban` to see exactly how the penalty data is structured. It then writes the Discord bot command using that exact JSON schema.

Generating code based on live responses prevents type errors and missing field bugs. Your agent tests the endpoints while writing the implementation.

You can place the configuration file in your home directory's .cursor folder to access these player queries across all your local projects. Project-level configs are better for team repositories.

Vinkius manages the authentication layer entirely on their managed infrastructure. Your editor only receives the raw session durations and server IPs, keeping your actual organization credentials off your local machine.

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