Skip to main content
Glama
outpost2026

lichess-mcp-analyzer

by outpost2026
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LICHESS_TOKENYesLichess API token (create at lichess.org/settings/oauth)
LLM_MAX_TOKENSNoOptional maximum tokens for LLM response (default 2000)
NVIDIA_API_KEYNoOptional NVIDIA API key for Nemotron model
CEREBRAS_API_KEYNoOptional Cerebras API key
DEEPSEEK_API_KEYNoOptional DeepSeek API key (shared for Chat and V4 Flash)
DEFAULT_PROVIDERNoOptional default LLM provider (cerebras, deepseek, or empty for auto)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
lichess_fetch_gamesB

Stahne recent hry hrace z Lichess/Chess.com.

Args:
    username: Lichess nebo Chess.com username
    max_games: Maximalni pocet her (1-50)
    source: Platforma - 'lichess' nebo 'chesscom'
lichess_analyze_game

Analyzes a chess game move by move using Stockfish.

Args:
    game_id: Lichess game ID (8 chars), or empty if using PGN directly
    pgn: PGN string of the game, or empty if using game_id
    username: Your username (to determine your color), or specify color
    color: Your color if username not provided ('white' or 'black')
    depth: Stockfish analysis depth (8-24, default 14)
lichess_analyze_position

Analyzes a chess position using Stockfish or Lichess cloud eval.

Args:
    fen: FEN string of the position
    depth: Stockfish analysis depth (8-24, default 18)
    use_cloud: Try Lichess cloud eval first (faster if cached)
lichess_opening_explorerA

Looks up a position in the Lichess Opening Explorer.

Args:
    fen: FEN string of the position
    source: Database - 'lichess' (public games) or 'masters' (OTB master games)
lichess_player_profileC

Returns a player's Lichess profile, ratings, and stats.

Args:
    username: Lichess username
lichess_diagnose_player

Diagnoses a player's weaknesses across multiple games.

Analyzes recent games and identifies recurring tactical blind spots,
phase weaknesses (opening/middlegame/endgame), leaky openings,
and pattern frequencies. Structured logging per P19.

Args:
    username: Lichess username
    max_games: Number of recent games to analyze (5-50)
    depth: Stockfish depth for analysis (8-18, lower = faster)
lichess_match_patternsA

Detects known playing patterns (A-Q1) from the player's pattern library.

Analyzes recent games and matches them against the pattern library
imported from chess_pattern_v5.json. Returns detected patterns with
confidence scores, evidence, mitigation advice, and compression validation.

Args:
    username: Lichess username
    max_games: Number of games to analyze (5-50)
    depth: Stockfish depth (8-18)
lichess_workspace_info

Returns workspace context for LLM agent orientation.

Provides root path, stockfish status, Python version, and registered tools count.

lichess_import_pgnA

Import and analyze a chess game from a PGN string.

Parses any PGN (lichess, chess.com, GM games, custom PGN) through the same
Stockfish pipeline used for online games. Returns per-move evaluation,
classification (blunder/mistake/inaccuracy/good/best), and phase detection.
Results are stored in L2 Resources for later retrieval.

Use this to:
- Analyze your own games from any platform
- Import GM games and compare against your patterns (via lichess_match_patterns)
- Analyze opponent games you have PGN for
- Build a custom game library from PGN files

Args:
    pgn: Full PGN string of the game (including headers)
    color: Your color ('white' or 'black', default 'white')
    depth: Stockfish analysis depth (8-24, default 14)
    game_id: Optional game identifier (auto-detected from PGN Site header if empty)

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
list_analysis_resourcesLists all stored analysis results.
list_pattern_resourcesLists all stored pattern detection results.
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.7/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: fetching games, importing PGN, matching patterns, opening explorer, and player profile. No overlap or ambiguity.

Naming Consistency4/5

All tools share the 'lichess_' prefix and use snake_case, but verbs are not uniformly applied: 'fetch_games', 'import_pgn', 'match_patterns' are verb_noun, while 'opening_explorer' and 'player_profile' are noun phrases. Minor inconsistency.

Tool Count5/5

Five tools is well-scoped for a chess analysis server. Each tool earns its place without being overwhelming or too sparse.

Completeness4/5

Covers core workflows: game retrieval, PGN import, pattern matching, opening lookup, and player stats. Missing a direct 'analyze game' tool that doesn't require separate PGN import, but the set is largely complete.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources