GRID.gg Esports

Provides access to GRID.gg Esports data via MCP tools for teams, matches, and event schemas.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "resilientbeast-grid-esports-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/grid-esports-mcp/dist/index.js"
      ],
      "env": {
        "GRID_API_KEY": "YOUR_ACTUAL_API_KEY_HERE"
      }
    }
  }
}

You can run a GRID.gg Esports MCP Server to bridge AI agents with GRID.gg data, enabling you to search teams, locate match replays, and understand complex match data for League of Legends and Valorant through ready-to-use MCP tools.

How to use

You will connect your MCP client to the GRID.gg MCP Server to access four tools: a GraphQL schema explorer, a live query executor, a replay file finder, and a hard-coded event definition dictionary. Use these to discover available fields, fetch Team IDs, Series/Match IDs, and Tournament details, locate specific JSONL replay files for a given match, and understand non-GraphQL event schemas such as ward placements or player movements. Integrate the server with your MCP client to perform queries, retrieve data, and parse event definitions in real time.

How to install

Follow these steps to install and run the GRID.gg MCP Server locally.

# 1. Clone the repository
git clone https://github.com/resilientbeast/grid-esports-mcp.git
cd grid-esports-mcp

# 2. Install dependencies
npm install

# 3. Build the server
npm run build

Configuration and usage notes

The server requires a GRID.gg API key to access the GRID Central Data API. Configure your MCP client to start the server with the API key provided.

{
  "mcpServers": {
    "gridgg": {
      "command": "node",
      "args": [
        "/absolute/path/to/grid-esports-mcp/dist/index.js"
      ],
      "env": {
        "GRID_API_KEY": "YOUR_ACTUAL_API_KEY_HERE"
      }
    }
  }
}

Start and run the MCP server

Run the server using Node with the built distribution and supply your GRID API key as an environment variable.

# Start the server (as shown in the configuration example)
node /absolute/path/to/grid-esports-mcp/dist/index.js

Available tools

explore_graphql_schema

Introspects the GRID Central Data API to learn available fields (Teams, Players, Tournaments) so you can write accurate queries without guessing.

execute_central_query

Executes live GraphQL queries to locate Team IDs, Series/Match IDs, and Tournament details.

list_match_files

Finds specific JSONL replay files (series-events) for a given match.

get_event_definition

Provides the hard-coded schema for complex in-game events (like ward-placed or player-moved) that aren’t available via GraphQL.