# BattleMetrics MCP for AI Agents AI Agent Connect > BattleMetrics MCP lets you pull real-time game server data and player analytics into your AI client. You can monitor server populations, search for specific players, and audit ban records without leaving your chat interface. It turns complex gaming data into direct answers. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_B5filKZVMkvsAzfqWGN4ijTZff8AjOEhgRA46XGk/ai-agent-connect - **Tags:** game-servers, player-analytics, ban-auditing, server-tracking, real-time-monitoring ## Description Managing a gaming community usually means jumping between dozens of tabs to check server health, find out who is causing trouble, and see if your player count is actually growing. This Connector changes that by giving your AI agent a direct line into the BattleMetrics ecosystem. Instead of hunting for a specific IP or digging through a database to find a player's history, you just ask. You can get a summary of a server's current status, see which players are most active, or pull a list of recent bans to see why people are being kicked. It is like having a data analyst who knows every server and player profile by heart. You can find this and hundreds of other tools in the Vinkius catalog to keep your stack connected. It moves the work from manual data entry and dashboard clicking into a simple conversation where you get the specific numbers you need to make decisions. ## Tools ### get_ban Get the specific reason, scope, and admin details for a single ban. This helps you audit why a player was removed. ### get_game Retrieve high-level metadata and server counts for a specific game. Use this to understand a game's overall ecosystem. ### get_server Get the IP, port, player count, and map for a specific server. Use this to show someone exactly where to connect. ### get_server_leaderboard See the most active players on a server with their playtime. It is perfect for finding your top contributors. ### list_bans Pull a list of all bans across your organization. You can filter these by specific servers or reasons. ### list_games See every game currently tracked by BattleMetrics. This helps you find the right game ID for your queries. ### list_players Search the global database for players by name. Use this to see if a specific user has an account. ### list_servers Get a general list of servers filtered by name, country, or game. This is your starting point for discovery. ### get_player_sessions See a history of every server a player joined and how long they stayed. This is vital for auditing behavior. ### search_servers Use advanced filters like player count range or rank to find specific servers. This is better for precise hunting. ### get_server_player_count_history Pull a timeline of player counts for a server. Use this to see peak hours and growth trends. ### get_player Pull a full profile for a player, including their Steam IDs and playtime. This is great for identifying known users. ## Prompt Examples **Prompt:** ``` Show me the most popular Rust servers in the US right now. ``` **Response:** ``` I've pulled the top Rust servers in the US. Here are the most populated ones: | Server Name | Players | Rank | IP Address | | :--- | :--- | :--- | :--- | | **Rust US East** | 142 | #1 | 192.168.1.1 | | **Rust West Coast** | 98 | #4 | 192.168.1.2 | | **Rust Central** | 85 | #7 | 192.168.1.3 | These servers currently have the highest activity in your region. ``` **Prompt:** ``` Look up the player 'shroud' and show me their recent session history. ``` **Response:** ``` I found the player **shroud**. Here is their recent activity: * **Server:** Rust US East (Joined: 2 hours ago, Duration: 45 mins) * **Server:** Rust West Coast (Joined: Yesterday, Duration: 2 hours) * **Server:** Rust Central (Joined: 3 days ago, Duration: 1 hour) Total playtime across these sessions is approximately **3 hours and 45 minutes**. ``` **Prompt:** ``` Show me the player count trend for server ID 12345 over the last 7 days. ``` **Response:** ``` I've pulled the population history for server 12345 over the last week. Here is the trend: * **Peak Hours:** 18:00 - 22:00 UTC * **Average Players:** 87 * **Low Activity:** 15 players (02:00 - 06:00 UTC) The data shows a steady growth of about 5% compared to the previous week. ``` ## Capabilities ### Find specific game servers Search for servers by name, country, or game type to get live stats. ### Pull player profiles Get identifiers, playtime, and linked server info for any player in the database. ### Audit player sessions See exactly when and where a player joined or left a server. ### Track population trends Analyze how many people are playing a server over a specific time range. ### Review ban history List and inspect organization-wide or server-level bans. ### Fetch server leaderboards Identify the most active players on a specific server. ### Explore game catalogs Get high-level stats on different game ecosystems. ## Use Cases ### Identifying a troublemaker A community manager notices a player being toxic. They ask the agent to list_bans for that user to see if they have a history of issues. ### Planning server maintenance An admin asks for the player count history for the last 7 days to find the lowest activity window for a reboot. ### Scouting for new servers An esports analyst asks the agent to search_servers for Rust servers in the US with more than 50 players. ### Verifying a pro player A scout asks the agent to get_player for a known name to see their playtime stats and which servers they frequent. ## Benefits - Stop manual dashboard checking. Use list_servers and search_servers to find the exact data you need in seconds instead of clicking through multiple pages. - Audit bans faster. Use list_bans and get_ban to see exactly why players are being removed and which admins are taking action across your organization. - Track player loyalty. Use get_player_sessions to see how often a player returns, helping you identify your most dedicated community members. - Analyze growth trends. Use get_server_player_count_history to see peak hours and activity patterns over days or weeks to plan your events. - Identify top players. Use get_server_leaderboard to quickly see who is putting in the most hours on your specific game servers. - Streamline player lookups. Use list_players to find user identifiers and stats across all supported games without manually searching every title. ## How It Works The bottom line is you get instant access to deep gaming data without ever opening a browser. 1. Subscribe to the BattleMetrics MCP on the Vinkius marketplace. 2. Paste your BattleMetrics Personal Access Token into your AI client settings. 3. Ask your agent to find a server, look up a player, or summarize ban data. ## Frequently Asked Questions **What can I do with the BattleMetrics MCP?** You can use your AI client to pull real-time game server data, search for player profiles, and audit ban records. It turns complex gaming data into simple, conversational answers. **Can I use BattleMetrics MCP to find my own server?** Yes. You can ask your agent to search for servers by name, country, or game type to find specific connection details like IPs and ports. **How do I audit bans using BattleMetrics MCP?** You can ask your agent to list all bans in your organization and then pull specific details for any ban ID to see the reason, scope, and the admin who issued it. **Can this tool show me player session history?** Yes. It can retrieve a history of which servers a player joined, when they arrived, when they left, and how long they stayed. **Is BattleMetrics MCP good for esports analysis?** It is excellent for analysts who need to track population trends, identify peak activity hours, and view time-based leaderboards for competitive servers. **Can I filter game servers by specific criteria?** Yes. You can use advanced filters to find servers based on player count ranges, rankings, and specific game titles. **How does BattleMetrics MCP help with community management?** It helps by allowing you to quickly identify active players, track their session habits, and review moderation actions without leaving your chat interface. **How do I find a specific game server?** Use the `list_servers` tool with the search parameter. You can filter by server name, game type (e.g. rust, ark), or country code (e.g. US, DE). The results include server name, IP, player count, and rank. For more advanced filtering (min/max players), use the `search_servers` tool. **Can I track a player's activity across different servers?** Yes. Use `list_players` to find the player by name, then `get_player` to view their full profile, and `get_player_sessions` to see their complete session history including which servers they joined, when they connected and disconnected, and for how long. **What games does BattleMetrics support?** BattleMetrics tracks hundreds of multiplayer games including Rust, ARK, Minecraft, CS2, Valheim, DayZ, and many more. Use the `list_games` tool to get the complete, up-to-date catalog of all supported games with their identifiers. **How do I get details about a specific ban?** First use `list_bans` to find the ban and get its numeric ban ID. Then use `get_ban` with that ID to retrieve the complete ban record including the reason, player identifier, expiry date, scope, and issuing administrator.