Skip to main content
Glama
bhayanak

Chess MCP Server

by bhayanak

Chess MCP Server

A Model Context Protocol (MCP) server for Chess.com — enabling AI assistants to explore player profiles, ratings, game archives, leaderboards, clubs, and puzzles.

CI License: MIT Node.js npm


What is this?

This MCP server wraps the Chess.com Published Data API — a free, no-auth API with data on 100M+ players. Use it with AI assistants like GitHub Copilot or Claude to:

  • Analyze Magnus Carlsen's blitz rating

  • Review Hikaru's latest bullet games

  • Compare any two players side by side

  • Get daily puzzles

  • Explore leaderboards, clubs, and tournaments

Related MCP server: MCP Chess Server

Packages

Package

Description

Docs

@fazorboy/chess-mcp-server

Core MCP server (npm) — use with Claude, VS Code, or any MCP client

Server README

chess-mcp-vscode

VS Code extension — one-click install, zero config

Extension README

Available Tools (12)

Tool

Description

gm_player_profile

Get player profile (name, title, country, followers)

gm_player_stats

Get ratings across all game types

gm_player_games

Get recent games with results and accuracy

gm_game_details

Get details for a specific game by URL

gm_game_archives

List all available monthly archives

gm_leaderboards

Global leaderboards by category

gm_titled_players

List all GMs, IMs, FMs, etc.

gm_club_info

Club information and stats

gm_club_members

List club members by activity

gm_player_tournaments

Tournament history and results

gm_compare_players

Side-by-side player comparison

gm_random_puzzle

Daily chess puzzle with FEN/PGN

Configuration

Settings can be configured via VS Code settings or environment variables:

Setting

Env Variable

Default

Description

chessMcp.baseUrl

CHESS_BASE_URL

https://api.chess.com

API base URL

chessMcp.maxGames

CHESS_MAX_GAMES

50

Max games per query

chessMcp.timeoutMs

CHESS_TIMEOUT_MS

15000

Request timeout (ms)

chessMcp.userAgent

CHESS_USER_AGENT

Chess-MCP/0.1.0

User-Agent header

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    B
    maintenance
    Provides access to Chess.com player data, game records, and public information through standardized MCP interfaces, allowing AI assistants to search and analyze chess information.
    10
    88
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Provides Chess.com player data integration, enabling AI assistants to fetch real-time chess player profiles and comprehensive statistics including ratings, game counts, and performance metrics from Chess.com's public API.
    2
    MIT
  • F
    license
    B
    quality
    D
    maintenance
    Provides tools to interact with the Chess.com Public API for fetching real-time player profiles and detailed game statistics. It enables LLMs to access information like player ratings, win/loss records, and current online status.
    2
    -
  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    Provides access to Chess.com's public API, allowing AI assistants to fetch player information and statistics.
    -