Chess.com

live Games

Look up Chess.com player profiles, game stats, monthly game archives, and leaderboards

4 tools
0ms auth
free tier 50 calls/day

Tools

get_player required: username

Get a Chess.com player's public profile including name, title, followers, country, join date, and last online time.

Parameters
Name Type Description
username req string Chess.com username (case-insensitive, e.g., "hikaru", "magnuscarlsen")
▶ Try it
get_stats required: username

Get a player's game statistics including current rating, best rating, and win/loss/draw record for daily, rapid, blitz, and bullet formats.

Parameters
Name Type Description
username req string Chess.com username
▶ Try it
get_games required: username, year, month

Get a player's completed games for a specific month. Returns game URLs, time controls, results, and player ratings.

Parameters
Name Type Description
username req string Chess.com username
year req number Year (e.g., 2024)
month req number Month as a number (1-12)
▶ Try it
get_leaderboards

Get the top-ranked Chess.com players across game formats including daily, rapid, blitz, and bullet.

No parameters required.

▶ Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash 
curl -X POST https://gateway.pipeworx.io/chess/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash 
curl -X POST https://gateway.pipeworx.io/chess/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_player","arguments":{"username": "octocat"}}}'