OP.GG MCP Server

1# OP.GG MCP Server
2 
3🇰🇷 [한국어](./README.ko.md) | 🇯🇵 [日本語](./README.ja.md) | 🇨🇳 [简体中文](./README.zh-CN.md) | 🇹🇼 [繁體中文](./README.zh-TW.md) | 🇧🇷 [Português](./README.pt-BR.md)
4 
5The OP.GG MCP Server is a [Model Context Protocol](https://modelcontextprotocol.io) implementation that provides AI agents with access to OP.GG game data for League of Legends, Teamfight Tactics, and Valorant.
6 
7![opgg-mcp-lol-leaderboard](https://github.com/user-attachments/assets/e89a77e7-0b83-4e20-a660-b16aa2d03fe2)
8 
9## Endpoint
10 
11```
12https://mcp-api.op.gg/mcp
13```
14 
15The server supports **Streamable HTTP** transport.
16 
17## Field Selection
18 
19Most tools require a `desired_output_fields` parameter to specify which fields to return. This reduces payload size and improves response efficiency.
20 
21### Syntax
22 
23| Pattern | Description | Example |
24|---------|-------------|---------|
25| `field` | Single field | `name` |
26| `parent.child` | Nested field | `data.summoner.level` |
27| `array[]` | Array field | `champions[]` |
28| `array[].field` | Field in array items | `data.champions[].name` |
29| `{a,b,c}` | Multiple fields at same level | `{name,title,lore}` |
30| `parent.{a,b}` | Multiple nested fields | `data.summoner.{level,name}` |
31| `array[].{a,b}` | Multiple fields in array items | `data.champions[].{name,title}` |
32 
33### Example
34 
35```json
36{
37  "desired_output_fields": [
38    "data.summoner.{game_name,tagline,level}",
39    "data.summoner.league_stats[].{game_type,win,lose}",
40    "data.summoner.league_stats[].tier_info.{tier,division,lp}"
41  ]
42}
43```
44 
45## Available Tools
46 
47### League of Legends
48 
49#### Champions
50| Tool | Description |
51|------|-------------|
52| `lol_get_champion_analysis` | Get detailed champion stats (win/pick/ban rates), optimal builds (items, runes, skills, spells), counter matchups, and team synergies |
53| `lol_get_champion_synergies` | Get champion synergy information |
54| `lol_get_lane_matchup_guide` | Get lane matchup guide for a specific lane |
55| `lol_list_champion_details` | Get ability, tip, lore, and stat metadata for up to 10 champions |
56| `lol_list_champion_leaderboard` | Get champion leaderboard data |
57| `lol_list_champions` | List all champion metadata |
58| `lol_list_lane_meta_champions` | Get lane-by-lane champion tiers with win/pick/ban rates, KDA, and tier rankings |
59 
60#### Summoners
61| Tool | Description |
62|------|-------------|
63| `lol_get_summoner_game_detail` | Get detailed information for a specific game (all players) |
64| `lol_get_summoner_profile` | Get summoner profile with rank, tier, LP, win rate, and champion pool |
65| `lol_list_summoner_matches` | Get recent match history with per-game stats |
66 
67#### Resources
68| Tool | Description |
69|------|-------------|
70| `lol_list_discounted_skins` | Get currently discounted skins |
71| `lol_list_items` | List all item metadata |
72 
73#### Pro Players
74| Tool | Description |
75|------|-------------|
76| `lol_get_pro_player_riot_id` | Get Riot ID for a pro player |
77 
78#### Esports
79| Tool | Description |
80|------|-------------|
81| `lol_esports_list_schedules` | Get upcoming LoL esports schedules with teams, leagues, and match times |
82| `lol_esports_list_team_standings` | Get team standings for a LoL league |
83 
84### Teamfight Tactics (TFT)
85 
86| Tool | Description |
87|------|-------------|
88| `tft_get_champion_item_build` | Get champion item build recommendations |
89| `tft_get_play_style` | Get play style recommendations |
90| `tft_list_augments` | Get augment list and descriptions |
91| `tft_list_champions_for_item` | Get champion recommendations for a specific item |
92| `tft_list_item_combinations` | Get item combination recipes |
93| `tft_list_meta_decks` | Get current meta decks |
94 
95### Valorant
96 
97| Tool | Description |
98|------|-------------|
99| `valorant_list_agent_compositions_for_map` | Get agent compositions for a specific map |
100| `valorant_list_agent_statistics` | Get agent statistics and meta data |
101| `valorant_list_agents` | Get agent metadata with abilities and roles |
102| `valorant_list_leaderboard` | Get leaderboard by region (ap, br, eu, kr, latam, na) |
103| `valorant_list_maps` | Get map metadata |
104| `valorant_list_player_matches` | Get player match history |
105 
106## License
107 
108This project is licensed under the MIT License - see the LICENSE file for details.
109 
110## Related Links
111 
112- [Model Context Protocol](https://modelcontextprotocol.io)
113- [OP.GG](https://op.gg)
114