OP.GG

The OP.GG MCP Server connects OP.GG data to AI agents and platforms, enabling you to retrieve a wide range of OP.GG data through a standardized MCP interface. This makes it easy to incorporate LoL, TFT, Valorant, and Esports data into your AI workflows and agents.

How to use

You can access OP.GG data from any MCP-compatible client by connecting to the remote MCP endpoint or by running the MCP runtime locally. Use the HTTP endpoint for a direct remote connection, or run the MCP runtime locally via a supported CLI to integrate the server into your agent framework.

How to install

Prerequisites: install Node.js and npm (or ensure you have an environment that can run MCP clients). You may also need a command-line tool compatible with MCP to start or connect to the server.

// Install and run via Smithery CLI (local runtime)
// This downloads and runs the OP.GG MCP Server local runtime via Smithery

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

// Start or run the MCP server locally via Smithery
npx -y @smithery/cli@latest run @opgginc/opgg-mcp --key {SMITHERY_API_KEY}

Configuration and environment

You can connect to the remote MCP endpoint or use the local runtime as described below. Ensure you set the appropriate API key if you are using Smithery for installation and operation.

// HTTP/MCP remote connection (preferred for direct access)
{
  "mcpServers": {
    "opgg_mcp": {
      "type": "http",
      "name": "opgg_mcp",
      "url": "https://mcp-api.op.gg/mcp",
      "args": []
    }
  }
}

// Local runtime connection via Smithery CLI
{
  "mcpServers": {
    "opgg_mcp": {
      "type": "stdio",
      "name": "opgg_mcp",
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@opgginc/opgg-mcp",
        "--key",
        "{SMITHERY_API_KEY}"
      ]
    }
  }
}

(Note: replace {SMITHERY_API_KEY} with your Smithery API key when using the local runtime.)

## Tools and data endpoints available

The OP.GG MCP Server exposes a set of tools to query League of Legends data, Esports schedules, TFT meta, and Valorant statistics. Each tool returns data in a format suitable for AI models and agent frameworks.

## MCP tools overview

Below is a list of the tools currently available and their purpose. This section lists tool names and concise descriptions so you can plan how to incorporate OP.GG data into your workflows.

## Security and access

Keep your API keys and access tokens secure. If you are using a cloud or shared environment, store keys in a secrets manager and reference them in your MCP client configuration rather than hard-coding values.

## Troubleshooting and notes

If you encounter connection issues, verify that the MCP endpoint URL is reachable and that your API key (if used) is valid. Check client logs for error messages and confirm that your MCP client is compatible with the server’s supported tools.

## Available tools

### lol-champion-leader-board

Fetches ranking board data for League of Legends champions.

### lol-champion-analysis

Provides analysis data for LoL champions, including weak counters and ban/pick data.

### lol-champion-meta-data

Retrieves meta data for a specific LoL champion with performance metrics.

### lol-champion-skin-sale

Retrieves information about LoL champion skins currently on sale.

### lol-summoner-search

Searches for LoL summoner information and stats.

### lol-champion-positions-data

Retrieves position-specific data for LoL champions, including win and pick rates by position.

### lol-summoner-game-history

Retrieves recent game history for a LoL summoner.

### lol-summoner-renewal

Refreshes and updates LoL summoner match history and statistics.

### esports-lol-schedules

Fetches upcoming LoL match schedules.

### esports-lol-team-standings

Retrieves team standings for a LoL league.

### tft-meta-trend-deck-list

Retrieves current TFT meta decks and trends.

### tft-meta-item-combinations

Provides information about TFT item combinations and recipes.

### tft-champion-item-build

Retrieves TFT champion item build guidance.

### tft-recommend-champion-for-item

Suggests champions for a given TFT item.

### tft-play-style-comment

Offers playstyle commentary for TFT champions.

### valorant-meta-maps

Provides meta data for Valorant maps.

### valorant-meta-characters

Provides meta data for Valorant characters.

### valorant-leaderboard

Fetches Valorant leaderboard data by region.

### valorant-agents-composition-with-map

Retrieves agent composition data for a Valorant map.

### valorant-characters-statistics

Retrieves Valorant character statistics, optionally filtered by map.

### valorant-player-match-history

Retrieves match history for a Valorant player by name and tag.