chesscom-stats-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CHESSCOM_USERNAME | No | Your Chess.com username. Optional: with it set, "how did I do?" means you; without it, name the player in the question. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_profileB | A Chess.com player's public profile: name, country, join date, league, followers. |
| get_ratingsA | Current and best rating plus lifetime win/loss/draw record for each time control (bullet, blitz, rapid, daily). |
| month_summaryA | How a player did in one calendar month: record and score, rating change per time control, results as white and black, average accuracy, how wins and losses ended, streaks, best win, worst loss and most-played openings. Defaults to the current month. Use this for questions like "how did I do this month?". |
| recent_gamesA | A player's most recent finished games, newest first, with result, ratings, opening, accuracy and a link. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool targets a distinct slice: profile identity, current/best ratings, a monthly aggregate, and a raw recent-games list. The only mild overlap is between month_summary and recent_games, both about played games, but the aggregate-vs-list distinction is spelled out clearly in the descriptions.
Two tools use a get_ verb prefix (get_profile, get_ratings) while the other two are bare noun phrases (month_summary, recent_games). Names are readable and unambiguous, but the set mixes two conventions rather than following one pattern.
Four tools is lean but sensible for a focused Chess.com stats server — identity, ratings, monthly performance, recent games. It sits just under a fully comfortable surface, since users may also want historical or arbitrary-range stats.
Core stats workflows are covered (profile, ratings, month summary, recent games), but there are notable gaps: no arbitrary date-range or archive queries, no fetching a specific game, and no puzzle/tactics or online-status data. Agents can work around some of this but will hit dead ends for historical queries.