Hosted MCP server · #111 most used on Smithery

Chessagine

jalpp/chessagine

Analyze chess positions using powerful engines like Stockfish, Leela, and Maia. Retrieve games, puzzles, and opening statistics directly from Lichess and specialized databases. Visualize moves and games through interactive board renders and PGN viewers.

Uses
5.0k
Tools
37
Runs
Hosted
Listed
9mo ago

Get started

Add it to your agent

npx -y @smithery/cli@latest install jalpp/chessagine --client claude

Swap --client claude for cursor, vscode, windsurf or another client. The CLI asks for any required settings.

What it can do

37 tools

get-lichess-master-games1 paramFetch master-level games and opening statistics from Lichess for a given position
ParameterTypeDescription
fenstringFEN string representing the board position
get-lichess-games1 paramFetch Lichess user games and opening statistics for a given position
ParameterTypeDescription
fenstringFEN string representing the board position
fetch-lichess-games1 paramFetch the 20 most recent games for a Lichess user. Returns game details including player information, ratings, speed format, and PGN nota…

Fetch the 20 most recent games for a Lichess user. Returns game details including player information, ratings, speed format, and PGN notation. Useful for analyzing a player's recent performance, openings, and game history.

ParameterTypeDescription
usernamestringLichess username to fetch games for
fetch-lichess-game1 paramFetch a specific Lichess game in PGN format. Accepts either a full Lichess URL or a game ID. Returns the complete PGN notation with heade…

Fetch a specific Lichess game in PGN format. Accepts either a full Lichess URL or a game ID. Returns the complete PGN notation with headers and moves, ready for analysis or display.

ParameterTypeDescription
gameUrlOrIdstringLichess game URL (e.g., https://lichess.org/abc12345) or game ID (e.g., abc12345)
fetch-chess-puzzle3 paramsFetch a random chess puzzle from Lichess database. Can filter by themes and rating range. Use this to start a puzzle session with the user.
ParameterTypeDescription
themesarrayArray of puzzle theme tags to filter by (e.g., ['fork', 'pin', 'mateIn2'])
ratingTonumberMaximum puzzle rating (e.g., 2000)
ratingFromnumberMinimum puzzle rating (e.g., 1000)
get-lichess-usernameGet the lichess username of current mcp user
fetch-lichess-studies1 paramFetch all studies for a given Lichess user. Returns a list of studies with their IDs, names, and timestamps. Requires either LICHESS_STUD…

Fetch all studies for a given Lichess user. Returns a list of studies with their IDs, names, and timestamps. Requires either LICHESS_STUDY_TOKEN environment variable or token parameter.

ParameterTypeDescription
usernamestringLichess username to fetch studies for
fetch-lichess-study-pgn1 paramFetch a specific Lichess study in PGN format. Returns all chapters of the study as PGN. Requires either LICHESS_STUDY_TOKEN environment v…

Fetch a specific Lichess study in PGN format. Returns all chapters of the study as PGN. Requires either LICHESS_STUDY_TOKEN environment variable or token parameter.

ParameterTypeDescription
studyIdstringLichess study ID (e.g., WTvnkWAL from https://lichess.org/study/WTvnkWAL)
render_chess_board1 paramRender an interactive chess board with the given position. Shows the board visually for a single position. Use this for displaying a spec…

Render an interactive chess board with the given position. Shows the board visually for a single position. Use this for displaying a specific chess position from FEN notation.

ParameterTypeDescription
fenstringFEN string representing the board position
render_pgn_viewer1 paramRender an interactive PGN game viewer that allows navigating through chess game moves. Use this for displaying complete chess games with …

Render an interactive PGN game viewer that allows navigating through chess game moves. Use this for displaying complete chess games with move history, annotations, and the ability to step through moves. Supports PGN format with headers like Event, Site, Date, White, Black, Result, and move notation.

ParameterTypeDescription
pgnstringGame PGN
is-legal-move2 paramsCheck if a given move is legal for the provided FEN position
ParameterTypeDescription
fenstringFEN string representing the board position, the fen must be in full form containing which side to move
movestringThe move to be played (in SAN or UCI format)
get-boardstate-for-move2 paramsGiven a FEN and a move, returns a string describing the resulting board state after the move
ParameterTypeDescription
fenstringFEN string representing the board position
movestringThe move to be played (in SAN or UCI format)
get-boardstate-for-fen1 paramGiven a FEN, returns a string describing the resulting board state for that FEN
ParameterTypeDescription
fenstringFEN string representing the board position
get-chessboardmagic-repertoiresFetch user's chess repertoires from the Chessboard Magic Repertoire Builder
get-chessboardmagic-gamesFetch user's chess games from the Chessboard Magic Repertoire Builder
get-chessboardmagic-game-details1 paramFetch user's single game's metadata, moves, tags, variations and comment links
ParameterTypeDescription
gameIdstringgame ID to fetch chessboardmagic game
get-chessboardmagic-repertoire-details1 paramFetch user's single repertoire metadata, moves, variations and comment links
ParameterTypeDescription
repertoireIdstringrepertoire ID to fetch a repertoire from chessboardmagic
get-chessboardmagic-tcec-stats1 paramFetch TCEC (Top Chess Engine Championship) statistics for a specific chess position
ParameterTypeDescription
fenstringFEN string representing the board position
get-chessboardmagic-tcec-games1 paramFetch TCEC games that reached a specific chess position
ParameterTypeDescription
fenstringFEN string representing the board position
get-chessboardmagic-corr-stats1 paramFetch correspondence chess statistics for a specific chess position
ParameterTypeDescription
fenstringFEN string representing the board position
get-chessboardmagic-corr-games1 paramFetch correspondence chess games that reached a specific chess position
ParameterTypeDescription
fenstringFEN string representing the board position
get-stockfish-analysis2 paramsAnalyze a chess position using Stockfish 18 Multi-threated Lite WASM engine
ParameterTypeDescription
fenstringFEN string representing the board position
depthnumberSearch depth for Stockfish engine
fen-openingbook-lookup1 paramLook up a fen in 12k positions of opening book to get name, moves information for fen
ParameterTypeDescription
fenstringFEN string representing the board position
get-stockfish-best-move2 paramsFind the best move in a chess position using Stockfish 18 Multi-threated Lite WASM engine
ParameterTypeDescription
fenstringFEN string representing the board position
depthnumberSearch depth for Stockfish engine
get-stockfish-multipv-analysis3 paramsAnalyze a chess position and get multiple best move candidates with Stockfish 18 Multi-threated Lite WASM engine
ParameterTypeDescription
fenstringFEN string representing the board position
depthnumberSearch depth for Stockfish engine
numLinesnumberNumber of best move lines to analyze (1-5)
get-stockfish-batch-analysis1 paramAnalyze multiple chess positions in batch using Stockfish 18 Multi-threated Lite WASM engine
ParameterTypeDescription
positionsarrayArray of positions to analyze
get-chess-knowledgebaseReturns a comprehensive chess knowledgebase including Silman Imbalances, Fine's 30 chess principles, endgame principles, and practical ch…

Returns a comprehensive chess knowledgebase including Silman Imbalances, Fine's 30 chess principles, endgame principles, and practical checklists

get-chessagine-stater-promptsList all available chess analysis prompt categories with their example prompts
get-puzzle-themesGet a list of all available puzzle themes that can be used to filter puzzles
parse-pgn-into-fens1 paramCollect a fen list of given game pgn
ParameterTypeDescription
pgnstringGame PGN
get-fen-map-lookup2 paramsLookup fens for mapped SAN move, for given game PGN
ParameterTypeDescription
pgnstringGame PGN
isAfterbooleanIf true, maps moves to FEN after the move; if false, maps to FEN before the move
get-chessdb-analysis1 paramFetch position analysis and candidate moves from ChessDB
ParameterTypeDescription
fenstringFEN string representing the board position
get-chessdb-pv1 paramFetch the principal variation (best line) for a position from ChessDB
ParameterTypeDescription
fenstringFEN string representing the board position
queue-chessdb-analysis1 paramQueue a chess position for background analysis on ChessDB
ParameterTypeDescription
fenstringFEN string representing the board position
get-maia2-analysis2 paramsAnalyze chess position using Maia2 neural network trained on human games at specific rating levels. Provides human-like move suggestions …

Analyze chess position using Maia2 neural network trained on human games at specific rating levels. Provides human-like move suggestions and evaluations tailored to player strength (1100-1900 rating).

ParameterTypeDescription
fenstringFEN string representing the board position
ratingnumberTarget player rating level for analysis, the rating must be the following values: [1100, 1200, 1300, 1400, 1500, 1600, 1700, 1800, 1900]
get-leela-analysis1 paramAnalyze chess position using Leela Chess Zero neural network. Provides strong tactical analysis with neural network evaluation and candid…

Analyze chess position using Leela Chess Zero neural network. Provides strong tactical analysis with neural network evaluation and candidate moves. Uses T1-256x10 neural net, trained on self played games

ParameterTypeDescription
fenstringFEN string representing the board position
get-elite-leela-analysis1 paramAnalyze chess position using Elite Leela Chess Zero with enhanced evaluation. Provides top-level computer analysis with deep neural netwo…

Analyze chess position using Elite Leela Chess Zero with enhanced evaluation. Provides top-level computer analysis with deep neural network insights. Trained on 20M games from Lichess Elite Database (2500 - 3000)

ParameterTypeDescription
fenstringFEN string representing the board position

Readable data

Resources

  • Chess Board ViewerInteractive chess board visualization for single positions
  • PGN Game ViewerInteractive PGN game viewer with move navigation and analysis