Chess.com MCP Server

by udarrr·io.github.udarrr/chess-mcp-node·v0.8.8

No reviews yet

MCP server for Chess.com player profiles, games, stats, puzzles, clubs, and tournaments

A88/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A88/100

full report

Adoption

New

0 stars55 downloads/wk

Reviews

Write one

Nobody has reviewed Chess.com MCP Server yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Chess.com MCP Server tools (30)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

download_player_games_pgn
Download PGN files for all games in a specific month from Chess.com
get_club_matches
Get team matches for a club on Chess.com
get_club_members
Get members of a club on Chess.com
get_club_profile
Get information about a club on Chess.com
get_country_clubs
Get clubs associated with a country on Chess.com
get_country_players
Get recently active players associated with a country on Chess.com
get_country_profile
Get a country profile on Chess.com
get_daily_puzzle
Get the current daily puzzle from Chess.com
get_leaderboards
Get Chess.com leaderboards
get_live_team_match
Get a live team match on Chess.com
get_live_team_match_board
Get a board from a live team match on Chess.com
get_player_clubs
Get the clubs a player belongs to on Chess.com
get_player_current_games
Get a player's ongoing games on Chess.com
get_player_game_archives
Get a list of available monthly game archives for a player on Chess.com
get_player_games_by_month
Get a player's games for a specific month from Chess.com
get_player_games_to_move
Get a player's daily games where they must act
get_player_live_games
Get a player's live games for a time control from Chess.com
get_player_matches
Get team matches involving a player on Chess.com
get_player_profile
Get a player's profile from Chess.com
get_player_stats
Get a player's stats from Chess.com
get_player_tournaments
Get tournaments involving a player on Chess.com
get_random_puzzle
Get a random daily puzzle from Chess.com
get_streamers
Get the current Chess.com streamer list
get_team_match
Get a daily team match on Chess.com
get_team_match_board
Get a board from a daily team match on Chess.com
get_titled_players
Get a list of titled players from Chess.com
get_tournament
Get information about a tournament on Chess.com
get_tournament_round
Get a tournament round on Chess.com
get_tournament_round_group
Get a tournament round group on Chess.com
is_player_online
Check if a player is currently online on Chess.com

Public scan report

scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it

no findings

Code scan6 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 40 days ago12/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Chess.com MCP Server compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 88/100; higher than 75% of 48,255 servers
Tools: 30; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 55; more than 46% of 12,191 servers with a package

What its tools let an agent do: 30 read

Install Chess.com MCP Server in Claude Code, Cursor or VS Code

Runs npx -y chess-mcp-node on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add chess-mcp-node -- npx -y chess-mcp-node

Add to Cursor

What the publisher says

From the Chess.com MCP Server repository's README, as published. We do not edit it. Read it on GitHub

Chess.com MCP Server

A Model Context Protocol server written in TypeScript for Chess.com's public API. It exposes the complete documented Chess.com PubAPI through 30 tools and seven resources without authentication.

Install from npm

Requirements: Node.js 20.9 or newer.

Run the latest published package directly:

npx -y chess-mcp-node@latest

The default transport is stdio. The package is distributed through npm and can also be installed from the VS Code MCP gallery after its registry metadata is published.

For VS Code, create or open .vscode/mcp.json in your workspace:

{
  "servers": {
    "chess": {
      "command": "npx",
      "args": ["-y", "chess-mcp-node@latest"]
    }
  }
}

After publication, search for @mcp chess in VS Code and select Install to add the server from the MCP gallery.

For Claude Desktop, add the server to its MCP configuration:

{
  "mcpServers": {
    "chess": {
      "command": "npx",
      "args": ["-y", "chess-mcp-node@latest"]
    }
  }
}

Run from source

Requirements: Node.js 20.9 or newer.

npm ci
npm run build
npm start

The default source-run transport is stdio. To run the optional SSE transport:

# macOS/Linux
MCP_TRANSPORT=sse npm start

# Windows PowerShell
$env:MCP_TRANSPORT = "sse"
npm start

The SSE server listens on port 8000 by default and provides /sse, /messages, and /health. Set PORT and HOST to override those defaults.

Set CHESSAPIBASE_URL to override the Chess.com API base URL for development or testing.

Development

Run the test suite and type checker:

npm test
npm run typecheck

Create a coverage report with:

npm run test:coverage

Available tools

getplayerprofile
gettitledplayers
getplayerstats
isplayeronline
getplayercurrent_games
getplayergamestomove
getplayergame_archives
getplayergamesbymonth
getplayerlive_games
downloadplayergames_pgn
getplayerclubs
getplayermatches

Available resources

chess://player/{username}
chess://player/{username}/stats
chess://player/{username}/games/current
chess://player/{username}/games/{year}/{month}
chess://player/{username}/games/{year}/{month}/pgn
chess://titled/{title}
chess://club/{url_id}

License

MIT

Nothing above is checked by us. What we check is on the safety report.

Chess.com MCP Server: common questions

Is Chess.com MCP Server safe?: Yes, by our scan: it is graded A (88/100). Read the Chess.com MCP Server safety report
How do I install Chess.com MCP Server?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Chess.com MCP Server need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Chess.com MCP Server maintained?: The last commit was 43 days ago (2026-09-22). The latest release is v0.8.8.
How does Chess.com MCP Server compare with other MCP servers?: safety score 88/100 (higher than 75% of 48,255 servers); tools 30 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.