VLR MCP
About
MCP server for accessing VLR.gg VALORANT esports data
Details
- Author
- okeahdavid
- Categories
- Web Scraping, Other
Jump to
Setup
Install VLR MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/okeahdavid/vlr-stats-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A Model Context Protocol (MCP) server that provides Claude with access to VLR.gg VALORANT esports data. Built with FastMCP for easy integration with Claude Desktop.
Player Profile: aspas Timespan: ALL Current Team: MIBR Team Page: https://www.vlr.gg/team/7386/mibr Profile: https://www.vlr.gg/player/8480/aspas --- Agent Statistics (ALL) --- 1. Jett - (226) 51% Rating: 1.26 | ACS: 249.8 | K:D: 1.45 Rounds: 4749 | ADR: 158.8 | KAST: 75% KPR: 0.91 | APR: 0.15 | FK/FD: 0.19/0.11 Kills: 4303 | Deaths: 2977 2. Raze - (112) 26% Rating: 1.19 | ACS: 247.0 | K:D: 1.25 Rounds: 2332 | ADR: 164.2 | KAST: 76% KPR: 0.87 | APR: 0.20 | FK/FD: 0.16/0.11 Kills: 2018 | Deaths: 1614
This MCP server provides the following tools to access VALORANT esports data:
- get_upcoming_matches- Get upcoming VALORANT matches with team names, events, and timing
- get_live_matches- Get matches that are currently LIVE, with the live map score
- get_match_results- View recent match results with scores and events
- get_match_details- Full detail for a single match: map veto, per-map scores, and the per-player scoreboard (agent, ACS, K/D/A, ADR)
- get_team_rankings- Access current team rankings (top 20 by region)
- search_team- Look up a team's profile: tag, active roster, and staff
- get_team_matches- Get recent or upcoming matches for a specific team
- get_head_to_head- Head-to-head W-L record and past meetings between two teams
- get_events- Browse ongoing, upcoming, and completed VALORANT tournaments
- get_event_details- Prize pool, dates, location, and participating teams for a single event
- get_player_stats- Get detailed player profile with agent statistics and performance metrics (supports time filtering: 30d, 60d, 90d, all)
- get_stats_leaderboard- Top players by Rating/ACS/K:D across a region and time window (30d/60d/90d), with paging
- get_agent_stats- Per-event agent pick rates and per-map attack/defense win rates
- get_news- Recent VALORANT esports articles (title, blurb, date, author)
git clone <your-repo-url> cd vlr-stats-mcp
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e .
Don't have uv? Install it:pip install uv
Add the MCP server to your Claude Desktop configuration:
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
- Linux:~/.config/Claude/claude_desktop_config.json
{ "mcpServers": { "vlr-stats": { "command": "python", "args": ["/absolute/path/to/vlr-stats-mcp/src/vlr_mcp.py"] } } }
For detailed setup instructions including WSL, Windows, and macOS configurations, seeSETUP.md
After adding the configuration, restart Claude Desktop completely and the VLR Stats tools will be available!
- "What VALORANT matches are live right now?"
- "What are the upcoming VALORANT matches?"
- "Show me recent match results"
- "Break down the G2 vs Xi Lai Gaming match map by map"
- "What are the current team rankings?"
- "What VALORANT events are happening now?"
- "Who's playing at Esports World Cup 2026 and what's the prize pool?"
- "What are G2 Esports' last 5 games?"
- "When does Paper Rex play next?"
- "Who's on the Sentinels roster?"
- "What's the head-to-head record between Sentinels and LOUD?"
- "What's aspas's most used agent in the last 90 days?"
- "Which agent does Demon1 have the best K:D with?"
- "Who are the top 10 players in EU over the last 30 days?"
- "Which agents are most picked at Esports World Cup 2026?"
- "What's the latest VALORANT roster news?"
- "Catch me up on recent VLR headlines"
Theget_player_statstool provides comprehensive agent performance data including:
- Most used agent- Primary agent pick with usage percentage
- Best K:D agent- Agent with highest kill/death ratio
- Highest ACS agent- Agent with highest average combat score
- Per-agent statistics: Rating, ACS, K:D, ADR, KAST, KPR, APR, FK/FD ratios
- Time filtering: View stats for last 30/60/90 days or all time
Run the comprehensive test suite to verify all tools:
- MCP server initialization
- All data-scraping tools
- Connection to VLR.gg
src/ vlr_mcp.py # Main MCP server (composes tool modules) config.py # Shared config + fetch/cache/search helpers tools/ matches.py # get_upcoming_matches, get_live_matches, get_match_results, get_match_details teams.py # get_team_rankings, search_team, get_team_matches, get_head_to_head players.py # get_player_stats events.py # get_events, get_event_details stats.py # get_stats_leaderboard agents.py # get_agent_stats news.py # get_news test_tools.py # Comprehensive test suite
- FastMCP- Simplified MCP server framework
- httpx- Async HTTP client for fetching VLR.gg data
- BeautifulSoup4- HTML parsing for extracting match and team data
Contributions are welcome! Feel free to open issues or submit pull requests.
This is an unofficial tool and is not affiliated with VLR.gg or Riot Games. Please respect VLR.gg's terms of service and rate limits.
Fetches horse racing news from the thoroughbreddailynews.com RSS feed.
Provides comprehensive NBA player statistics from basketball-reference.com, including career stats, season comparisons, and advanced metrics.
Live sports scores and stats from NBA, NFL, and NHL
MPC server dedicated to gather information for videogames
An MCP server that provides chess statistics for any player.
Unofficial CLI + MCP server for eliteprospects.com Resources
Real-time surf, trails, volcano, ocean safety, weather, and restaurants for all Hawaiian islands — built for AI agents.
Real-time football live scores, fixtures, team stats, and player data from 1000+ leagues via SSE transport. Free, no API key required.
Provides access to information about free games on the Epic Games Store.
Interact with RuneScape (RS) and Old School RuneScape (OSRS) data, including item prices and player hiscores.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
