VLR.gg Dev API MCP Server
Valorant esports data from vlr.gg for AI clients, via the vlrdevapi Python package
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 3.1.2
- Listing updated
- today
Similar MCP servers
About VLR.gg Dev API MCP Server
VLR.gg Dev API MCP Server is an open-source MCP server for sports data. It runs locally on your machine and is started by your AI client.
Behind this server sits vlrdevapi, a typed Python client that reads match, team, player and event pages from vlr.gg and returns validated Pydantic models. The MCP side is the vlrdevapi-mcp stdio server, which the README says exposes 40 tools and installs with the mcp extra.
Coverage goes well past scoreboards. The library describes round-by-round economy tables, kill-feed timelines with map coordinates, player loadouts, historical ratings such as ACS, K/D, ADR and KAST, roster transactions and prize earnings. Requests go through a token-bucket rate limiter with retries and caching.
It runs locally over stdio, so you install it from PyPI and point Claude Desktop, Cursor or Zed at it. It suits analysts, Discord bot authors and anyone who wants an assistant to answer questions about Valorant matches.
Install
Run in a terminal
claude mcp add vlrdevapi -- uvx vlrdevapiAdd to claude_desktop_config.json
{
"mcpServers": {
"vlrdevapi": {
"command": "uvx",
"args": [
"vlrdevapi"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"vlrdevapi": {
"command": "uvx",
"args": [
"vlrdevapi"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"vlrdevapi": {
"type": "stdio",
"command": "uvx",
"args": [
"vlrdevapi"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"vlrdevapi": {
"command": "uvx",
"args": [
"vlrdevapi"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"vlrdevapi": {
"command": "uvx",
"args": [
"vlrdevapi"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Live and upcoming matches
- Reads live scores, schedules and completed match history.
- Series deep dives
- Covers economy, replay timelines, player stats, rounds and VODs for a series.
- Player and team profiles
- Returns ratings, agent pools, rosters, placements and transactions.
- Event brackets and standings
- Exposes stages, standings, prize pools and participating teams.
- Table exports
- The Python library can export results to pandas, polars, CSV, Parquet, Excel and JSON.
Good for
- Ask which team is playing next and when
- Compare a player's agent pool and rating across seasons
- Pull the economy breakdown of a specific map for analysis
- Build a Discord bot that answers esports stats questions
Pricing
Open source
MIT licence badge in the README
VLR.gg Dev API MCP Server FAQ
What does it need to run?
Python 3.11 or newer and the vlrdevapi package, installed with the mcp extra.
How many tools does it have?
The README says the stdio server offers 40 tools.
Is it open source?
The README shows an MIT licence badge.
Is VLR.gg Dev API MCP Server free?
Yes. VLR.gg Dev API MCP Server is open source, so you can use and self-host it for free.
How do I add VLR.gg Dev API MCP Server to Claude Code?
Run this command in your terminal: claude mcp add vlrdevapi -- uvx vlrdevapi
What are the best alternatives to VLR.gg Dev API MCP Server?
The closest alternatives to VLR.gg Dev API MCP Server are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


