League Of Legends Mock Match Predictor

Created By
onepersonunicorna year ago
AI-powered League of Legends professional esports match predictor and summoner analysis tool. Predict outcomes for T1, Faker, Zeus, and other pro players with advanced statistical modeling.
Overview

League of Legends Mock Match MCP

⚔️ AI-powered League of Legends mock match simulator and summoner comparison tool

This Model Context Protocol (MCP) server provides comprehensive League of Legends summoner analysis and mock match simulations based on historical performance data from the last 10 games.

Features

  • 🔍 Summoner Analysis: Get detailed statistics including KDA, damage dealt, and win rates
  • ⚔️ Mock Match Simulation: AI-powered 10-phase match progression simulation
  • 🌍 Multi-language Support: Available in 7 languages
  • 📊 Performance Comparison: Side-by-side summoner comparisons
  • 🎯 Match Prediction: Outcome prediction based on historical data

Supported Languages

  • English (EN/ENGLISH)
  • Korean (한국어)
  • Traditional Chinese (繁體中文)
  • Japanese (日本語)
  • Spanish (ESPAÑOL)
  • Bengali (বাংলা)
  • Punjabi (ਪੰਜਾਬੀ)

Installation

Prerequisites

  • Python 3.10 or higher
  • pip package manager

Setup

  1. Clone the repository:

    git clone https://github.com/onepersonunicorn/lolgpt.git
    cd lolgpt
    
  2. Install dependencies:

    pip install -r requirements.txt
    
  3. Set up environment variables (optional):

    export LOL_API_URL="https://1tier.xyz"
    export LOL_DEFAULT_LANGUAGE="EN"
    export LOL_API_TIMEOUT="30"
    
  4. Run the server:

    python main.py
    

Usage

Available Tools

The MCP server provides 6 different tools for various League of Legends simulation needs:

league_of_legends_summoner_vs_match

Main tool for comprehensive match simulation.

Parameters:

  • uidA (required): Riot ID of first summoner
  • tagA (required): Tag of first summoner
  • uidB (required): Riot ID of second summoner
  • tagB (required): Tag of second summoner
  • lang (optional): Language for simulation (default: "EN")

Example API call

await league_of_legends_summoner_vs_match(
    uidA="Hide on bush",
    tagA="KR1", 
    uidB="Zeus",
    tagB="KR1",
    lang="EN"
)

Example Usage

conversations

Sample Output

🎮 **League of Legends Mock Match Simulation**
════════════════════════════════════════════

📊 Summoner A (PlayerOne#KR1) - Last 10 Games Statistics:
• Average Kills: 8.2
• Average Assists: 12.5
• Average Deaths: 4.1
• Average KDA: 5.05
• Average Damage Dealt: 28,450
• Win Rate: 70%

📊 Summoner B (PlayerTwo#NA1) - Last 10 Games Statistics:
• Average Kills: 6.8
• Average Assists: 9.2
• Average Deaths: 5.3
• Average KDA: 3.02
• Average Damage Dealt: 22,100
• Win Rate: 55%

🎯 Mock Match Simulation - Summoner's Rift:
════════════════════════════════════════════

Phase 1: Welcome to the Snowdown Showdown.
Phase 2: Thirty seconds until minions spawn.
Phase 3: Minions have spawned!
Phase 4: First blood! Zeus has been slain.
Phase 5: Hide on bush has slain an enemy!
Phase 6: Hide on bush has destroyed a turret.
Phase 7: Zeus Quadrakill!
Phase 8: Hide on bush is legendary!
Phase 9: Hide on bush has destroyed a inhibitor.
Phase 10: Hide on bush victory!

### Smithery Configuration

The server supports Smithery configuration via `smithery.yaml`:

startCommand:
  type: stdio
  configSchema:
    properties:
      debug:
        type: boolean
        default: false
      apiUrl:
        type: string
        default: "https://1tier.xyz"
      language:
        type: string
        default: "EN"
      timeout:
        type: number
        default: 30

API Integration

The server integrates with the 1tier.xyz API endpoint which provides:

  • Summoner Statistics: Last 10 games performance data
  • Match Simulation: AI-generated match progression
  • Multi-language Support: Localized simulation text
  • Real-time Data: Current summoner performance metrics

License

This project is licensed under the MIT License

Disclaimer

League of Legends mock match simulations are for entertainment purposes only. Results are based on historical performance data and do not guarantee actual match outcomes. League of Legends is a trademark of Riot Games, Inc.

Support

For issues and questions:

  • Create an issue on GitHub
  • Contact the development team

Acknowledgments

  • Riot Games for League of Legends
  • 1tier.xyz for providing the API infrastructure

Made with ❤️ for the League of Legends community

Server Config

{
  "mcpServers": {
    "lolgpt": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/onepersonunicorn/lolgpt.git",
        "python",
        "-c",
        "import main; main.main()"
      ]
    }
  }
}
Project Info
Created At
a year ago
Updated At
a year ago
Author Name
onepersonunicorn
Star
-
Language
-
License
-
Category

Recommend Servers

View All
Thousand Api

13 hours ago
Mercury X402 Mcp

9 hours ago
GovQL
@Alex Stout

# govql-mcp-server An MCP (Model Context Protocol) server for [GovQL](https://govql.us) — gives AI clients like Claude Desktop, Claude Code, and Cursor direct access to the US Congressional GraphQL API at [api.govql.us/graphql](https://api.govql.us/graphql) without bespoke HTTP wiring. For the design rationale (why FastMCP-Python, the passthrough+curated philosophy, roadmap through v0.4), see [design.md](https://github.com/govql/govql/blob/main/mcp-server/docs/design.md). ## What you can do with it Ask an agent questions like: - *"How did Vermont's two senators vote on the most recent nomination?"* - *"Which legislators in the 118th Congress switched parties during their service?"* - *"Compare Senator Sanders' voting record to Senator Murkowski's on cloture votes in the most recent Congress."* The agent picks the right tool, writes the GraphQL query against the live schema, and parses the response — no manual API wrangling. ## Install The server runs as a per-client subprocess over stdio. Pick your client: ### Claude Desktop Edit `claude_desktop_config.json` (Settings → Developer → Edit Config): ```json { "mcpServers": { "govql": { "command": "uvx", "args": ["govql-mcp-server"] } } } ``` Restart Claude Desktop. The `govql` tools appear in the tools panel. ### Claude Code Add to `.mcp.json` in your project (or `~/.mcp.json` for global): ```json { "mcpServers": { "govql": { "command": "uvx", "args": ["govql-mcp-server"] } } } ``` ### Cursor Settings → MCP → Add Server. Use the same `command` / `args` as above. ### Other clients Any MCP-compatible client that supports stdio servers will work. The command is `uvx govql-mcp-server` with no required arguments. ## Tools | Tool | Purpose | |---|---| | `execute_graphql` | Run any GraphQL query against the GovQL endpoint. Returns the result plus an `last_ingest` timestamp so the agent can reason about data freshness. | | `list_types` | Returns the names and kinds of every type in the GovQL schema. Optional `kind` filter (`"OBJECT"`, `"INPUT_OBJECT"`, `"ENUM"`, etc.) to narrow further. Start here when you don't know what's queryable. | | `describe_type` | Returns one type's full details — fields, arg signatures, input fields, enum values. Call after `list_types` to learn the shape of a specific type before writing a query. | ## Configuration All env vars are optional — the package is zero-config for end users. | Env var | Default | Purpose | |---|---|---| | `GOVQL_ENDPOINT` | `https://api.govql.us/graphql` | Endpoint to query. Override to point at a local dev stack. | | `GOVQL_TIMEOUT_MS` | `30000` | Per-request HTTP timeout. | | `LOG_LEVEL` | `INFO` | Logging level. Logs go to stderr only (stdout is reserved for the MCP transport). | ## Limits (enforced by the upstream API) - Max query depth: 10 - Max query complexity: ~10 billion points (`first: N` multiplies child cost by N — keep page sizes reasonable on deeply nested queries) - Rate limit: 100 requests / 60 s per source IP A depth or complexity violation surfaces as a GraphQL `errors` entry in the tool response so the agent can adjust and retry. ## Data freshness Every `execute_graphql` response includes a `last_ingest` ISO timestamp. Vote data refreshes hourly; legislator data refreshes daily. ## Status Version 0.1.0 ships three foundational tools: a GraphQL passthrough (`execute_graphql`) and two narrow schema-discovery tools (`list_types`, `describe_type`). Curated higher-level tools (`find_legislator`, `get_voting_record`, `compare_voters`, etc.) are planned for subsequent releases — see [design.md](https://github.com/govql/govql/blob/main/mcp-server/docs/design.md) for the roadmap. ## Links - [GovQL project site](https://govql.us) - [GraphQL API](https://api.govql.us/graphql) - [Source / issues](https://github.com/govql/govql)

2 days ago