Chess.com#

Pull player profiles, ratings across all time controls, historical game archives, and global leaderboards from Chess.com's public API. No authentication needed.

Tools#

ToolDescriptionget_playerPublic profile for a Chess.com username (e.g., "hikaru", "magnuscarlsen")get_statsRatings and win/loss/draw counts for bullet, blitz, rapid, and dailyget_gamesGame archive for a specific month — includes PGN, time control, and resultsget_leaderboardsTop players globally across all time controls

When to use#

• Looking up a player's current rating or recent performance
• Analyzing game archives for a specific player and month
• Comparing ratings across time controls for coaching conversations
• Displaying leaderboard rankings in a chess community tool

Example: Hikaru's blitz stats#

bash

curl -s -X POST https://gateway.pipeworx.io/chess/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_stats","arguments":{"username":"hikaru"}}}'

Returns ratings, win/loss/draw for each time control, plus best rating achieved and date.

MCP client config#

json

{
  "mcpServers": {
    "pipeworx-chess": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://gateway.pipeworx.io/chess/mcp"]
    }
  }
}