OP.GG MCP Server

OP.GG MCP Server

What is OP.GG MCP Server about?

The server exposes a collection of tools that retrieve OP.GG data—such as champion rankings, summoner stats, match histories, esports schedules, and Valorant meta information—through the Model Context Protocol. AI agents can invoke these tools to obtain up‑to‑date gaming insights without building custom scrapers.

How to use OP.GG MCP Server?

1. Direct connection – Add a supergateway entry to your MCP configuration (e.g., claude_desktop_config.json):

   {
     "mcpServers": {
       "opgg-mcp": {
         "command": "npx",
         "args": ["-y", "supergateway", "--streamableHttp", "https://mcp-api.op.gg/mcp"]
       }
     }
   }
   

2. Smithery installation – Install the server via the Smithery CLI:

   npx -y @smithery/cli@latest install @opgginc/opgg-mcp --client claude --key {SMITHERY_API_KEY}
   

   Then add the corresponding @smithery/cli run command to the MCP config (similar JSON structure, but using the Smithery package).
3. Restart your AI client (e.g., Claude Desktop) to load the new tools.

Key Features

• League of Legends: champion leader‑boards, analysis, meta data, skin sales, summoner search, game history, position statistics, and summoner data renewal.
• Esports (LoL): upcoming match schedules and league team standings.
• Teamfight Tactics: current meta deck lists, item combinations, champion item builds, item‑based champion recommendations, and play‑style comments.
• Valorant: map meta, character meta, regional leaderboards, agent composition per map, character statistics, and player match history.
• MCP‑compatible: works with any client that supports the Model Context Protocol (Claude Desktop, etc.).

Use Cases

• AI‑driven coaching bots that give real‑time advice to players based on champion counters and meta trends.
• Game analytics dashboards that pull up‑to‑date leader‑board and performance metrics without manual data pipelines.
• Esports commentators retrieving schedules and standings on‑the‑fly during live broadcasts.
• Personal game assistants that fetch a player's recent match history, suggest optimal builds, or recommend agents for a Valorant map.
• Content creators generating data‑rich videos or articles using automated data retrieval.

FAQ

Q: Do I need an API key? A: The direct supergateway connection does not require an API key. Smithery installation may need a Smithery API key for licensing.

Q: Which platforms are supported? A: Any MCP‑compatible client (Claude Desktop is the primary example) can use the server.

Q: How are updates handled? A: The server pulls data from OP.GG’s backend, so updates are reflected automatically when the tools are invoked.

Q: Can I add custom tools? A: Yes, you can extend the MCP server by defining additional functions following the MCP specification.

Q: Is the server open source? A: The project is licensed under the MIT License and the source code is available on GitHub.

OP.GG MCP Server

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), 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-leader-board: Get ranking board data for League of Legends champions.
• lol-champion-analysis: Provides analysis data for League of Legends champions (counter and ban/pick data available in the "weakCounters" field).
• lol-champion-meta-data: Retrieves meta data for a specific champion, including statistics and performance metrics.
• lol-champion-skin-sale: Retrieves information about champion skins that are currently on sale.
• lol-summoner-search: Search for League of Legends summoner information and stats.
• lol-champion-positions-data: Retrieves position statistics data for League of Legends champions, including win rates and pick rates by position.
• lol-summoner-game-history: Retrieve recent game history for a League of Legends summoner.
• lol-summoner-renewal: Refresh and update League of Legends summoner match history and stats.

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-match-history: 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.

Direct Connection via StreamableHttp

If you want to connect directly to our StreamableHttp endpoint, you can use the supergateway 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

{
  "mcpServers": {
    "opgg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://mcp-api.op.gg/mcp"
      ]
    }
  }
}

Windows

{
  "mcpServers": {
    "opgg-mcp": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://mcp-api.op.gg/mcp"
      ]
    }
  }
}

This configuration will use the supergateway package to establish a direct connection to our StreamableHttp endpoint, providing you with immediate access to all OP.GG data tools.

Installing via Smithery

To install OP.GG MCP for Claude Desktop automatically via Smithery:

$ 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

{
  "mcpServers": {
    "opgg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@opgginc/opgg-mcp",
        "--key",
        "{SMITHERY_API_KEY}"
      ]
    }
  }
}

Windows

{
  "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.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related Links

• Model Context Protocol
• OP.GG