https://github.com/opgginc/opgg-mcp
https://github.com/opgginc/opgg-mcp
Last synced: 5 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/opgginc/opgg-mcp
- Owner: opgginc
- License: mit
- Created: 2025-04-08T21:44:27.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-26T02:33:03.000Z (17 days ago)
- Last Synced: 2025-05-07T18:16:54.542Z (5 days ago)
- Language: TypeScript
- Size: 26.4 KB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - OP.GG - Access real-time gaming data across popular titles like League of Legends, TFT, and Valorant, offering champion analytics, esports schedules, meta compositions, and character statistics. (Official Servers)
- awesome-mcp-servers - opgginc/opgg-mcp - League of Legends、TFT、Valorantなどの人気ゲームのリアルタイムゲームデータにアクセスし、チャンピオン分析、eスポーツスケジュール、メタ構成、キャラクター統計を提供します。 (サーバー実装 / 🎮 <a name="gaming"></a> ゲーミング)
README
# OP.GG MCP Server
[](https://smithery.ai/server/@opgginc/opgg-mcp)
The OP.GG MCP Server is a Model Context Protocol implementation that seamlessly connects OP.GG data with AI agents and platforms. This server enables AI agents to retrieve various OP.GG data via function calling.
## Overview
This MCP server provides AI agents with access to OP.GG data through a standardized interface. It offers a simple way to connect to our remote server (https://mcp-api.op.gg/mcp/sse), allowing for easy installation and immediate access to OP.GG data in a format that's easily consumable by AI models and agent frameworks.
## Features
The OP.GG MCP Server currently supports the following tools:
### League of Legends
- **lol-champion-analysis**: Fetch analysis data for a specific champion
- **lol-champion-leader-board**: Fetch that champion's rank
### Esports (League of Legends)
- **esports-lol-schedules**: Get upcoming LoL match schedules
- **esports-lol-team-standings**: Get team standings for a LoL league
### Teamfight Tactics (TFT)
- **tft-meta-trend-deck-list**: TFT deck list tool for retrieving current meta decks
- **tft-meta-item-combinations**: TFT tool for retrieving information about item combinations and recipes
- **tft-champion-item-build**: TFT tool for retrieving champion item build information
- **tft-recommend-champion-for-item**: TFT tool for retrieving champion recommendations for a specific item
- **tft-play-style-comment**: This tool provides comments on the playstyle of TFT champions
### Valorant
- **valorant-meta-maps**: Valorant map meta data
- **valorant-meta-characters**: Valorant character meta data
- **valorant-leaderboard**: Fetch Valorant leaderboard by region
- **valorant-agents-composition-with-map**: Retrieve agent composition data for a Valorant map
- **valorant-characters-statistics**: Retrieve character statistics data for Valorant, optionally filtered by map
- **valorant-player-matches**: Retrieve match history for a Valorant player using their game name and tag line
## Usage
The OP.GG MCP Server can be used with any MCP-compatible client. The following content explains installation methods using Claude Desktop as an example.
### Installing via Smithery
To install OP.GG MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@opgginc/opgg-mcp):
```bash
$ npx -y @smithery/cli@latest install @opgginc/opgg-mcp --client claude --key {SMITHERY_API_KEY}
```
### Adding to MCP Configuration
To add this server to your Claude Desktop MCP configuration, add the following entry to your `claude_desktop_config.json` file:
#### Mac/Linux
```json
{
"mcpServers": {
"opgg-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli@latest",
"run",
"@opgginc/opgg-mcp",
"--key",
"{SMITHERY_API_KEY}"
]
}
}
}
```
#### Windows
```json
{
"mcpServers": {
"opgg-mcp": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@smithery/cli@latest",
"run",
"@opgginc/opgg-mcp",
"--key",
"{SMITHERY_API_KEY}"
]
}
}
}
```
After adding the configuration, restart Claude Desktop for the changes to take effect.
### Direct Connection via SSE
If you want to connect directly to our SSE endpoint, you can use the `mcp-remote` package. This provides a simple way to connect to our remote server without having to install the full OP.GG MCP Server.
Add the following to your `claude_desktop_config.json` file:
#### Mac/Linux
```json
{
"mcpServers": {
"opgg-mcp": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp-api.op.gg/mcp/sse"
]
}
}
}
```
#### Windows
```json
{
"mcpServers": {
"opgg-mcp": {
"command": "cmd",
"args": [
"/c",
"npx",
"mcp-remote",
"https://mcp-api.op.gg/mcp/sse"
]
}
}
}
```
This configuration will use the `mcp-remote` package to establish a direct connection to our SSE endpoint, providing you with immediate access to all OP.GG data tools.
### Listing Available Tools
```json
{
"method": "tools/list",
"params": {}
}
```
Response:
```json
{
"tools": [
{
"name": "lol-champion-analysis",
"description": "Fetch analysis data for a specific champion"
},
{
"name": "lol-champion-leader-board",
"description": "Fetch that champion's rank"
},
{
"name": "esports-lol-schedules",
"description": "Get upcoming LoL match schedules"
},
{
"name": "esports-lol-team-standings",
"description": "Get team standings for a LoL league"
},
{
"name": "tft-meta-trend-deck-list",
"description": "TFT deck list tool for retrieving current meta decks"
},
{
"name": "tft-meta-item-combinations",
"description": "TFT tool for retrieving information about item combinations and recipes"
},
{
"name": "tft-champion-item-build",
"description": "TFT tool for retrieving champion item build information"
},
{
"name": "tft-recommend-champion-for-item",
"description": "TFT tool for retrieving champion recommendations for a specific item"
},
{
"name": "tft-play-style-comment",
"description": "This tool provides comments on the playstyle of TFT champions"
},
{
"name": "valorant-meta-maps",
"description": "Valorant map meta data"
},
{
"name": "valorant-meta-characters",
"description": "Valorant character meta data"
},
{
"name": "valorant-leaderboard",
"description": "Fetch Valorant leaderboard by region"
},
{
"name": "valorant-agents-composition-with-map",
"description": "Retrieve agent composition data for a Valorant map"
},
{
"name": "valorant-characters-statistics",
"description": "Retrieve character statistics data for Valorant, optionally filtered by map"
},
{
"name": "valorant-player-matches",
"description": "Retrieve match history for a Valorant player using their game name and tag line"
}
]
}
```
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Related Links
- [Model Context Protocol](https://modelcontextprotocol.io)
- [OP.GG](https://op.gg)