valorant-mcp 0.3.0

Add your description here

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

Tool	Description
get_player_info	Fetch basic account info for a Riot ID
get_match_history	Recent competitive match history with detailed stats for you and teammates
get_match_details	Full breakdown of a specific match including kills, rounds, and first bloods
get_agent_stats	Aggregated per-agent stats: win rate, avg KDA, avg score
get_map_stats	Aggregated per-map stats: win rate, avg score
get_weapon_stats	Weapon usage stats: kills per weapon, usage percentage
get_rank_progression	Current rank, elo, peak rank, and season history

Setup

Prerequisites

• uv package manager
• 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 (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Supported regions: na, eu, ap, kr

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

Run the server

uv run valorant-mcp

Test with MCP Inspector

mcp dev src/valorant_mcp/server.py

Run tests

uv run pytest src/valorant_mcp/tests/ -v

Tech Stack

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

License

MIT