Skip to content
MCP server

VLR.gg Dev API MCP Server

Valorant esports data from vlr.gg for AI clients, via the vlrdevapi Python package

Runs locallyStatus and history
Install
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 vlrdevapi

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vlrdevapi": {
      "command": "uvx",
      "args": [
        "vlrdevapi"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vlrdevapi": {
      "command": "uvx",
      "args": [
        "vlrdevapi"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers