# VSPN Esports DB MCP > VSPN Esports DB pulls live, detailed data from major esports tournaments like Honor of Kings and LoL. Your agent can fetch current standings, full team rosters, round-by-round scorecards, and granular player stats (KDA) on demand. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** esports, tournament-management, match-analysis, player-telemetry, live-brackets ## Description Need to analyze what's happening in a massive esports tournament? This MCP connects your AI client directly to VSPN, Asia’s primary source for league data. You can pull everything from live bracket schedules to deep individual player performance metrics. Instead of manually refreshing multiple websites to track team movements or playoff trees, your agent does the heavy lifting automatically. When you run complex analyses across different tournament stages, Vinkius AI Analytics gives you a full audit trail, letting you see exactly which pieces of data flowed through and how much budget was used. This means no black box operations—you know precisely what every call did. You can query active team lineups or calculate aggregate stats for entire teams on the fly. It's all about getting reliable, granular esports intelligence without ever leaving your workflow. ## Tools ### get_match_detail Pulls complete data for a single match instance. ### get_match_stream Retrieves active live streaming URLs for an ongoing match. ### get_matches Lists all matches scheduled within a specific tournament. ### getPlayerStats Pulls detailed individual player performance metrics for any given match or tournament. ### get_players Provides the list of players currently rostered on a team. ### get_standings Fetches the current ranking and points for groups or leagues. ### get_team_stats Gets aggregate performance statistics for an entire team across multiple matches. ### get_teams Lists all the participating esports teams in the database. ### get_tournament_detail Retrieves general information about a specific tournament event. ### get_tournaments Gets a list of all currently active VSPN tournaments. ## Prompt Examples **Prompt:** ``` Get the current team standings for the KPL Spring 2024 group stage. ``` **Response:** ``` Group Stage standings retrieved! Team Wolves leads Group A with 12 points (4W-0L), followed closely by eStar Pro at 9 points (3W-1L). Group B is tighter with QGhappy and Hero Jiuyue tied at 6 points each. Would you like me to pull the upcoming match schedule for the next round? ``` **Prompt:** ``` Show me the full match telemetry for match ID KPL-2024-0412. ``` **Response:** ``` Match KPL-2024-0412 telemetry loaded! Team Wolves vs. eStar Pro — final score 3-1. Game 1: Wolves won with a 12K gold lead at 18 minutes. MVP: Player 'FlyCat' with KDA 7/1/9. Game 2: eStar Pro bounced back winning a 35-minute macro contest. Should I export the full per-player stat sheet? ``` **Prompt:** ``` List all active roster members for team 'QGhappy' with their current KDA averages. ``` **Response:** ``` QGhappy roster retrieved! 5 active players this season: 'Fly' (Mid, KDA 5.2), 'Cat' (Jungle, KDA 4.8), 'Hurt' (Clash Lane, KDA 3.9), 'Qing' (Support, KDA 7.1), and 'Xiào' (Farm Lane, KDA 4.5). Last roster change: 'Qing' promoted from substitute on March 15. Would you like a comparison against last season's performance? ``` ## Capabilities ### Get Live Standings Retrieves current points and win/loss records for groups and tournaments. ### List Full Rosters Pulls the active players, substitutes, and positional roles for any team. ### Track Match Progress Gets deep details on a single match, including map wins and MVP selections. ### Analyze Player Metrics Calculates individual statistics like KDA ratios and damage output for specific players. ### View Tournament Schedules Lists upcoming matches, group stages, and playoff bracket information. ## Use Cases ### Writing a Post-Match Analysis An esports journalist needs to compare Team A's KDA against their previous opponent. They ask the agent to use `getPlayerStats` for both teams and then ask the agent to summarize the difference in damage output, generating a complete draft section instantly. ### Building Live Broadcast Graphics A broadcast producer needs stats for an upcoming round. They first call `get_tournaments` to find the correct bracket, then use `get_matches` and finally `get_match_detail` to pull all necessary data points for a real-time graphic overlay. ### Fantasy League Data Calculation A fantasy operator wants to calculate custom scoring models based on team performance. The agent uses `get_team_stats` to gather aggregate metrics, then feeds that into an external calculation script for a final score. ### Checking Roster Changes A content creator needs to confirm if a star player has switched teams. They use `get_players` on two different team IDs and ask the agent to flag any discrepancies or roster additions since last week's match. ## Benefits - Instead of manually checking standings pages, use `get_standings` to pull real-time tournament rankings directly into your report. - Generate deep player profiles for every match. The `getPlayerStats` tool gives you specific KDA ratios and objective contribution data for analysis. - Need to know who's playing? Use `get_players` and `get_teams` together to instantly validate a team’s current active lineup or see recent transfer movements. - Stop juggling multiple web tabs. With `get_tournament_detail`, you get all the core info—like playoff structure and dates—in one data pull, not ten clicks. - When running complex automations, Vinkius AI Analytics gives you a full audit trail of every data point pulled from this MCP, so nothing happens in the dark. ## How It Works The bottom line is you can treat live esports databases like simple, conversational API endpoints. 1. First, you must get API access from the VSPN Developer Portal and obtain a Bearer Token. 2. Next, paste that token into your agent's connection settings; it authenticates against all VSPN REST endpoints. 3. Finally, ask your agent to perform an action—like listing upcoming brackets or fetching player stats—and the data appears instantly. ## Frequently Asked Questions **How do I find out what teams are playing next?** Use `get_matches` to list matches within a specific tournament. You'll need the tournament ID to run this tool successfully. This gives you all upcoming game details. **Can I get detailed info about one match using get_match_detail?** Yes, `get_match_detail` pulls comprehensive data for a single match. It includes scorecards and key performance indicators that define the match outcome. **What if I want to see all active players on one team? Do I use get_players?** You're right, `get_players` is exactly what you need. It lists every player rostered for a specific team ID and helps track changes. **How do I get general info about the whole competition?** Run `get_tournament_detail`. This provides high-level information, like the overall format or the dates of the event, which is useful for articles and scheduling. **If I need to access live broadcast links, how do I use the `get_match_stream` tool?** This tool retrieves the direct streaming URLs for a match. It provides real-time endpoints so your agent can monitor the broadcast feed without manual URL refreshing. This is essential for production teams needing immediate stream data. **When I call `get_team_stats`, what kind of aggregate performance metrics can I pull for a team?** The `get_team_stats` function provides comprehensive, cumulative statistics for an entire squad. You get totals like overall damage output, average map victories, and accumulated objective contributions across multiple matches. **I need deep individual performance data; is `getPlayerStats` the right tool to use?** Yes, `getPlayerStats` pulls detailed telemetry for any specific player. You can audit metrics like KDA ratios and damage output directly from the game feed. This lets you track an athlete's true impact beyond just wins or losses. **When I use `get_standings`, what criteria determine the team rankings and points displayed?** The `get_standings` tool provides the current official tournament leaderboard. The standings are calculated based on weighted performance metrics, including wins, losses, and points assigned by the league ruleset. It's always up-to-date with group stage changes. **What game titles and leagues does VSPN cover?** VSPN operates major leagues including KPL (Honor of Kings Pro League), PEL (Peacekeeper Elite League), and LPL ecosystem pipelines. The availability of telemetry data depends on your API access tier and the specific league season. **Can I retrieve detailed round-by-round stats for a specific match?** Yes! Use the `get_match_details` tool with the match ID. It returns granular data including individual player KDA, damage dealt, objectives secured, and team gold differentials for each round played. **Are there any write or administrative capabilities that could affect tournament data?** No. All tools are strictly read-only, designed for data retrieval and analysis. You cannot modify tournament brackets, player records, or match results through this integration — ensuring complete data integrity at all times.