Add your description here
Project description
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 by match ID |
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_rank_progression |
Current rank, elo, peak rank, and season history |
Setup
Prerequisites
- Python 3.13+
- uv package manager
- A Henrik API key
Install
git clone https://github.com/SeijiMatsumoto/valorant-mcp.git
cd valorant-mcp
uv sync
Configure
Create a .env file in the project root:
HENRIK_API_KEY=your-api-key-here
VALORANT_REGION=na
Supported regions: na, eu, ap, kr
Add to Claude Code
claude mcp add valorant-analyzer -- uv run valorant-mcp
Add to Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"valorant-analyzer": {
"command": "uv",
"args": ["run", "valorant-mcp"],
"cwd": "/path/to/valorant-mcp"
}
}
}
Development
Run the server directly
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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file valorant_mcp-0.1.0.tar.gz.
File metadata
- Download URL: valorant_mcp-0.1.0.tar.gz
- Upload date:
- Size: 551.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fa7b1cf34758ddc913ceffe842696b6a4b70c00ce7d2584d93f63702cdbb87ce
|
|
| MD5 |
7d115f15494708cf054ec7465ec47843
|
|
| BLAKE2b-256 |
1d45500a91574cefc852de1d5190f8bbdbc5a480d132d25c307895ae2d0d3a3d
|
File details
Details for the file valorant_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: valorant_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 14.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d7b87a6b35e6928728cbc242f49fafa288c7a1a86e88dfaf5507460cba4d0d6b
|
|
| MD5 |
623316f20d4d3a651066a33fc06ce427
|
|
| BLAKE2b-256 |
1348d053d418632ff54b360236e72dff3e7ca6fb8d10b20ac796e6ac4fa48916
|
