Which integrations are available for this server?

Offers community support through a Discord server for ChessAgine users to get help and engage with other chess enthusiasts. Integrates with GitHub for project hosting, issue tracking, feature requests, and accessing releases including the MCPB installation files. Provides access to Lichess's extensive chess database including 3+ million tactical puzzles with theme filtering, master game statistics, opening explorer data, and user game history retrieval for comprehensive chess analysis and training.

How do I use ChessAgine MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ChessAgine MCP analyze this chess position: r1bqkbnr/pppp1ppp/2n5/4p3/4P3/5N2/PPPP1PPP/RNBQKB1R w KQkq - 2 3" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ChessAgine MCP

ChessAgine MCP is a Model Context Protocol server that gives LLMs deep chess awareness by exposing real-time board state, Stockfish analysis, opening databases, Lichess games, and neural engines including Maia2, Leela, and Elite Leela.

It also renders individual positions and full PGN games for in-depth visual analysis—enabling AI agents to reason about positions, evaluate variations, detect themes, explore game databases, and interact directly with chess engines.

Preview

Installation

Option 1: Using MCPB File (Recommended)

Download the chessagine-mcp.mcpb file and install it directly in Claude Desktop:

Download the latest release from GitHub releases
Open Claude Desktop
Go to Settings → Extensions → Install from file
Select the chessagine-mcp.mcpb file
Restart Claude Desktop

NOTE

To make sure its working correctly ask it to render the chessboard or a specific chess query

Option 2: Local Development Setup

Prerequisites

Node.js 22+
npm or yarn package manager

Clone and Setup

git clone https://github.com/jalpp/chessagine-mcp.git cd chessagine-mcp npm install npm run build

Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

macOS/Linux:

{ "mcpServers": { "chessagine-mcp": { "command": "node", "args": ["/absolute/path/to/chessagine-mcp/build/runner/stdio.js"] } } }

Windows:

{ "mcpServers": { "chessagine-mcp": { "command": "node", "args": ["C:\\absolute\\path\\to\\chessagine-mcp\\build\\runner\\stdio.js"] } } }

Usage:

show me my last Lichess game I played, I'm insert_your_username there, also analyze the game using Stockfish
given fen compare and constrast what stockfish thinks vs Leela and Maia
analyze my opening rep from Chessboard magic.

ChessAgine.Skill

to properly use ChessAgine MCP, give LLM access to how to properly use the it via .skill file here

Deploy your own instance

You can deploy your own copy to Vercel in a few clicks:

Fork this repo
Go to vercel.com/new and import your fork
No environment variables needed — just deploy
Your server will be at https://your-project.vercel.app/mcp

Dev commands

npm run build:mcp # Builds the mcp server layer which generates mcpb file npm run build:ui # Builds the ChessAgine MCP UI html files npm run build # Builds entire project, use for local development npm run start # starts the MCP server npm run debug # opens MCP inspector to inspect new changes made