LoL Data MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add lol-data-mcp -- npx -y @estaed/lol-data-mcp
README.md

A comprehensive League of Legends data ecosystem for the Model Context Protocol.

🚧 PROJECT UNDER MAJOR RESTRUCTURE 🚧

LoL Data MCP Server is currently undergoing comprehensive restructuring and enhancement. This project will cover significantly more functionality than originally planned.

šŸ”„ Current Status: Major Expansion in Progress

This project is being actively restructured to become a comprehensive League of Legends data ecosystem that will include:

šŸŽÆ Planned Coverage Areas (Under Development)

**Phase 1: Core Data Infrastructure** ⚔
  • Champion Data System: Complete champion statistics, abilities, and patch history
  • Item Data System: Item statistics, build paths, and patch tracking
  • Runes & Masteries: Complete rune system integration
  • Game Mechanics: Damage calculations, scaling formulas, and interactions
**Phase 2: Advanced Analytics** šŸ“Š
  • Meta Analysis: Patch-by-patch meta evolution tracking
  • Build Optimization: AI-powered optimal builds for different scenarios
  • Champion Synergies: Advanced team composition analysis
  • Performance Metrics: Win rates, pick/ban statistics, and trend analysis
**Phase 3: AI Integration** šŸ¤–
  • Training Data Generation: Structured datasets for machine learning
  • Game State Recognition: Real-time game state parsing and analysis
  • Decision Support: AI-powered recommendations for in-game decisions
  • Simulation Environment: Complete LoL simulation for AI training
**Phase 4: Real-Time Services** ⚔
  • Live Match Data: Real-time match tracking and analysis
  • Player Analytics: Individual player performance tracking
  • Meta Predictions: AI-powered meta shift predictions
  • Community Integration: Discord bots, web APIs, and mobile apps
**Phase 5: Advanced Features** šŸš€
  • Video Analysis: Automatic highlight detection and analysis
  • Voice Integration: Voice-activated champion information and builds
  • AR/VR Support: Immersive data visualization for coaching
  • Esports Analytics: Professional match analysis and statistics

šŸ› ļø Technical Scope Expansion

**Data Sources Integration**

  • League of Legends Wiki: Primary source for comprehensive game data
  • Riot Games API: Official live data and statistics
  • Community Platforms: Reddit, Discord, and forums for meta insights
  • Esports Platforms: Professional match data and analytics
  • Streaming Platforms: Popular streamer builds and strategies

**Technology Stack Enhancement**

  • Backend: FastAPI, WebSocket, async/await patterns
  • Data Processing: BeautifulSoup, Selenium, pandas, numpy
  • AI/ML: TensorFlow, PyTorch, scikit-learn for analytics
  • Caching: Redis for high-performance data caching
  • Database: PostgreSQL for structured data, MongoDB for flexible schemas
  • API Integration: RESTful APIs, GraphQL, WebSocket real-time updates

**Integration Capabilities**

  • IDE Integration: Cursor, VS Code, JetBrains via MCP protocol
  • Discord Bots: Real-time champion information and builds
  • Web Applications: React/Vue frontends for data visualization
  • Mobile Apps: React Native for on-the-go access
  • CLI Tools: Command-line utilities for developers
  • Game Overlays: In-game information overlays

šŸŽÆ Project Timeline

Current Phase: Core Infrastructure Development
Expected Completion: Rolling releases with major milestones every 2-4 weeks
Full Feature Set: Estimated 6-12 months for complete ecosystem

šŸ”— Related Projects

This MCP server will serve as the data backbone for:

  • LoL Simulation Environment: AI training environments
  • Taric AI Agent: Specialized support champion AI
  • Community Tools: Discord bots, web apps, and mobile applications
  • Research Projects: Academic and professional esports analytics

šŸ“‹ Development Status

āœ… Currently Implemented:

  • Basic MCP server infrastructure
  • Champion statistics scraping (with level-specific data)
  • Champion abilities extraction
  • Item patch history tracking
  • Real-time wiki data integration

šŸ”„ Under Active Development:

  • Advanced item data system
  • Comprehensive patch tracking
  • Enhanced data accuracy and validation
  • Performance optimization and caching

šŸ“‹ Planned Features:

  • Complete runes and masteries system
  • Build recommendation engine
  • Meta analysis and tracking
  • Real-time match integration
  • AI-powered insights and recommendations

⚔ This project represents a significant expansion beyond the original scope and will become a comprehensive League of Legends data ecosystem serving multiple AI, analytics, and community applications.

šŸš€ Stay tuned for regular updates as we build the most comprehensive LoL data service available.

Tools (3)

get_champion_statsRetrieve detailed statistics and level-specific data for a specific champion.
get_champion_abilitiesExtract ability details and mechanics for a given champion.
get_item_patch_historyTrack historical changes and statistics for specific game items.

Configuration

claude_desktop_config.json
{"mcpServers": {"lol-data": {"command": "npx", "args": ["-y", "@estaed/lol-data-mcp"]}}}

Try it

→What are the base stats and ability scaling for Ahri at level 18?
→Can you explain the recent patch history changes for the item Infinity Edge?
→List all abilities for Jinx and describe their primary mechanics.
→Compare the base health and armor growth of Garen versus Darius.

Frequently Asked Questions

What are the key features of LoL Data MCP Server?

Champion statistics scraping with level-specific data. Extraction of champion ability mechanics. Item patch history tracking. Real-time League of Legends wiki data integration.

What can I use LoL Data MCP Server for?

Analyzing champion scaling for build optimization. Tracking meta evolution through patch history data. Retrieving quick champion ability information during game analysis. Generating structured datasets for game mechanics research.

How do I install LoL Data MCP Server?

Install LoL Data MCP Server by running: npx -y @estaed/lol-data-mcp

What MCP clients work with LoL Data MCP Server?

LoL Data MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep LoL Data MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare