ChessAgine MCP

{ "manifest_version": "0.2", "name": "chessagine-mcp-v0.4.4", "version": "1.0.7", "description": "Connect to ChessAgine Chess Context Protocol tools, access to stockfish analysis, chess board state, analysis of themes making LLM more chess aware, get access to chessdb, and lichess games, chessboardmagic.", "author": { "name": "Jalp", "url": "https://github.com/jalpp" }, "icon": "icon.png", "screenshots": [ "assets/screenshots/claude2.png", "assets/screenshots/claude3.png", "assets/screenshots/claude4.png" ], "documentation": "https://github.com/jalpp/chessagine-mcp", "support": "https://discord.gg/N2J2sP9yTm", "server": { "type": "node", "entry_point": "/build/runner/stdio.js", "mcp_config": { "command": "node", "args": [ "${__dirname}/build/runner/stdio.js" ], "env": { "LICHESS_API_TOKEN": "${user_config.LICHESS_API_KEY}", "LICHESS_USERNAME": "${user_config.LICHESS_USERNAME}", "CHESSBOARD_MAGIC_PAT": "${user_config.CHESSBOARD_MAGIC_PAT}" } } }, "user_config": { "LICHESS_API_KEY": { "type": "string", "title": "Lichess Study API Key", "description": "Your Lichess API token with study:read permission. Get a PAT from Lichess here https://lichess.org/account/oauth/token", "sensitive": true, "required": false }, "LICHESS_USERNAME": { "type": "string", "title": "Your Lichess Username", "description": "Enter your Lichess Username, to help LLM pull your games and other lichess tools", "sensitive": false, "required": false }, "CHESSBOARD_MAGIC_PAT": { "type": "string", "title": "ChessBoardMagic PAT Key", "description": "Your ChessBoard Magic Personal Access Token (PAT) which you get from here https://chessboardmagic.com/", "sensitive": true, "required": false } }, "tools": [ { "name": "get-theme-scores", "description": "Analyze chess position themes (material, mobility, space, positional factors, king safety) for strategic evaluation from white or black perspective." }, { "name": "analyze-variation-themes", "description": "Track how chess themes evolve across a sequence of moves, showing positional changes and strategic developments in variations." }, { "name": "get-theme-progression", "description": "Monitor the progression of a specific chess theme (material/mobility/space/positional/king safety) throughout a variation of moves." }, { "name": "compare-variations", "description": "Compare multiple chess variations side-by-side, analyzing theme changes and strategic differences to identify the strongest continuation." }, { "name": "find-critical-moments", "description": "Identify key moves in a variation where significant theme changes occur, highlighting turning points and critical decision moments." }, { "name": "get-stockfish-analysis", "description": "Perform deep Stockfish engine analysis of any chess position, providing best moves, evaluation scores, principal variations, and strategic reasoning." }, { "name": "get-best-move", "description": "Analyze a position and get best move" }, { "name": "is-legal-move", "description": "Verify if a proposed move is legal in the given chess position, ensuring move validation before analysis or gameplay." }, { "name": "boardstate-to-prompt", "description": "Generate detailed text description of a chess position after a move, converting board state into natural language for analysis and discussion." }, { "name": "get-chess-knowledgebase", "description": "Access comprehensive chess knowledge including Silman's imbalances, Fine's principles, endgame theory, and practical improvement checklists." }, { "name": "get-lichess-master-games", "description": "Retrieve master-level games and opening statistics from Lichess database for any position, including win rates and popular continuations." }, { "name": "get-lichess-games", "description": "Fetch regular Lichess user games and opening statistics, providing insights into how positions are played at various skill levels." }, { "name": "get-chessdb-analysis", "description": "Query ChessDB for position analysis with candidate moves, evaluations, win rates, and move quality ratings from extensive game databases." }, { "name": "generate-chess-board-view-artificat-using-html", "description": "Renders chess board in HTML" }, { "name": "generate-dynamic-gameview-html", "description": "Render dynamic chess game" }, { "name": "fetch-chess-puzzle", "description": "Fetches puzzles from Lichess puzzle database, can query by theme or rating" }, { "name": "get-puzzle-themes", "description": "gets the puzzle themes" }, { "name": "fetch-user-recent-games-from-lichess", "description": "Fetch 20 recent games from Lichess" }, { "name": "fetch-lichess-game", "description": "fetch a single lichess game" }, { "name": "generate-game-review", "description": "Generate detailed game review dashboard or text version using theme stats" } ], "prompts": [ { "name": "chessagine-mode", "description": "Activate ChessAgine: Advanced chess analysis with engine integration", "text": "Activate ChessAgine mode for advanced chess analysis" }, { "name": "annotation-expert", "description": "Become a chess annotation expert for game commentary", "text": "Activate annotation expert mode for professional game commentary" }, { "name": "dashboard-designer", "description": "Create beautiful chess dashboards and visualizations", "text": "Activate dashboard designer mode for chess visualizations" }, { "name": "analyze-position", "description": "Comprehensive position analysis using chess principles", "arguments": ["fen", "side"], "text": "Analyze this chess position from ${arguments.side}'s perspective: ${arguments.fen}" }, { "name": "find-tactics", "description": "Search for tactical opportunities in a position", "arguments": ["fen", "side"], "text": "Find all tactical opportunities for ${arguments.side} in position: ${arguments.fen}" }, { "name": "opening-analysis", "description": "Analyze opening position and suggest plans", "arguments": ["fen"], "text": "Analyze this opening position and provide strategic plans: ${arguments.fen}" }, { "name": "endgame-analysis", "description": "Analyze endgame position with technique guidance", "arguments": ["fen"], "text": "Analyze this endgame position and provide winning/drawing technique: ${arguments.fen}" }, { "name": "annotate-game", "description": "Create detailed annotations for a chess game", "arguments": ["pgn"], "text": "Annotate this chess game with detailed commentary: ${arguments.pgn}" }, { "name": "compare-games", "description": "Compare two games to find patterns", "arguments": ["pgn1", "pgn2"], "text": "Compare these two chess games and analyze patterns: Game 1: ${arguments.pgn1}, Game 2: ${arguments.pgn2}" }, { "name": "explain-mistake", "description": "Deep dive into why a move was a mistake", "arguments": ["fen", "move", "bestMove"], "text": "Explain why ${arguments.move} was a mistake in position ${arguments.fen}. Best move: ${arguments.bestMove}" }, { "name": "create-training-plan", "description": "Generate a personalized chess improvement plan", "arguments": ["level", "weakness", "timePerDay"], "text": "Create a chess training plan for ${arguments.level} level, focusing on ${arguments.weakness}, with ${arguments.timePerDay} minutes per day" }, { "name": "build-repertoire", "description": "Create an opening repertoire recommendation", "arguments": ["color", "style", "timeControl"], "text": "Build a ${arguments.style} opening repertoire for ${arguments.color} in ${arguments.timeControl} games" }, { "name": "identify-patterns", "description": "Find recurring patterns in a position", "arguments": ["fen"], "text": "Identify all chess patterns (tactical, positional, strategic) in position: ${arguments.fen}" }, { "name": "start-study-session", "description": "Begin a focused chess study session", "arguments": ["topic", "duration"], "text": "Start a ${arguments.duration}-minute focused study session on ${arguments.topic}" } ], "keywords": [ "chess", "stockfish", "analysis", "opening", "database", "lichess", "chessdb", "strategy", "tactics", "engine", "training", "puzzles", "endgame", "repertoire", "annotation" ], "license": "MIT" }