# VLR.gg Dev API MCP Server

> VLR.gg Dev API MCP Server is an open-source MCP server for sports data. Valorant esports data from vlr.gg for AI clients, via the vlrdevapi Python package. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/vanshbordia/vlrdevapi
- **MCP Registry name:** io.github.Vanshbordia/vlrdevapi
- **Categories:** [sports data](https://ai-powered.com/categories/sports-data), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add vlrdevapi -- uvx vlrdevapi
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vlrdevapi": {
      "command": "uvx",
      "args": [
        "vlrdevapi"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vlrdevapi": {
      "command": "uvx",
      "args": [
        "vlrdevapi"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vlrdevapi": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "vlrdevapi"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vlrdevapi": {
      "command": "uvx",
      "args": [
        "vlrdevapi"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vlrdevapi": {
      "command": "uvx",
      "args": [
        "vlrdevapi"
      ]
    }
  }
}
```

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/vlr-gg-dev-api-mcp-server
