Valorant MCP Server

An MCP (Model Context Protocol) server that exposes Valorant match analysis tools. Connect it to Claude (or any MCP-compatible client) to fetch and analyze player stats, match history, agent performance, and more.

Powered by Henrik's Unofficial Valorant API.

Tools

Also exposed:

• Prompt coach_review: runs the tools and writes a keep / change / experiment review.
• Resource valorant://glossary: definitions of every metric (trade chance, isolated death, buy thresholds, confidence ranges, ...).

Percentages that depend on sample size come with *_ci95 95% confidence ranges so small samples aren't over-read.

Setup

Prerequisites

• uv package manager:

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

  (Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex")
• A Henrik API key

Claude Code

claude mcp add valorant-analyzer -e HENRIK_API_KEY=your-key-here -- uvx valorant-mcp

Claude Desktop

Add to your Claude Desktop config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "valorant-analyzer": {
      "command": "uvx",
      "args": ["valorant-mcp"],
      "env": {
        "HENRIK_API_KEY": "your-key-here"
      }
    }
  }
}

Local Development

git clone https://github.com/SeijiMatsumoto/valorant-mcp.git
cd valorant-mcp
uv sync

Create a .env file in the project root:

HENRIK_API_KEY=your-api-key-here

Optional settings (env vars or .env):

Run the server

uv run valorant-mcp

Test with MCP Inspector

mcp dev src/valorant_mcp/server.py

Run tests

Live tests need HENRIK_API_KEY and VALORANT_SMOKE_PLAYER=name#TAG in your .env.

uv run pytest                 # offline unit tests (HTTP is mocked)
uv run pytest -m live         # smoke tests against the real Henrik API (~13 of your 30 requests/min)

Tech Stack

• MCP Python SDK (FastMCP) — server framework
• httpx — async HTTP client
• Pydantic — data validation
• uv — package management

License

MIT