chess-mcp
chess-mcp is hosted online, so all tools can be tested directly either in theInspector tabor in theOnline Client.
If you are the rightful owner of chess-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server for Chess.com's Published Data API.
EvaluationTotal Score: 8/10
Evaluation Summary
- Strengths:
-
- Accuracy/Correctness:
-
- The agent consistently identifies and corrects case sensitivity issues with Chess.com usernames, ensuring accurate data retrieval.
-
- It provides detailed and accurate information about player profiles, game summaries, and club details, aligning with available data.
-
- Completeness:
-
- The agent offers comprehensive summaries of player statistics and game details, providing valuable insights into player performance.
-
- Consistency with Claimed Capabilities:
-
- The agent demonstrates its ability to perform tasks as outlined in its self-description, such as retrieving player profiles, game archives, and club information.
-
- Usefulness / Clarity:
-
- Information is well-organized with clear headings and bullet points, enhancing readability and user comprehension.
- Weaknesses:
-
- Accuracy/Correctness:
-
- There are occasional discrepancies in numerical data, such as member counts and ratings, which could be improved for accuracy.
-
- The agent sometimes fails to retrieve certain information, such as a player's current online status or specific event details.
-
- Completeness:
-
- The agent occasionally provides partial information, such as not including all games in a summary or lacking context about recent player activities.
-
- Usefulness / Clarity:
-
- The agent could enhance clarity by specifying the date of statistics and including time controls for games, as well as offering brief analyses or highlights.
- Suggestions for Improvement:
-
- Enhance Data Accuracy:
-
- Ensure all numerical data is up-to-date and accurately reflects the most recent information available.
-
- Provide Comprehensive Information:
-
- Include all relevant data or clearly state if only a selection is provided, and offer additional context where possible.
-
- Offer Analytical Insights:
-
- Provide brief analyses or highlight notable moments from games to offer users more value and understanding.
- Overall, the agent performs well in retrieving and presenting chess-related data but could improve in data accuracy and completeness to fully meet user expectations.
Test case 1
Score: 7/10Can you provide the current profile and stats for the Chess.com player 'Hikaru', and confirm if he is currently online?It looks like there was an issue when trying to retrieve the profile, stats, and online status for the player 'Hikaru'. The API returned a redirect response indicating that the username is case-sensitive and should be 'hikaru' instead of 'Hikaru'.
I'll try again using the correct username. Let's proceed with that. Here's the information I found for the Chess.com player Hikaru Nakamura:
Profile
- Name: Hikaru Nakamura
- Username: hikaru
- Title: Grandmaster (GM)
- Location: Florida, USA
- Followers: 1,269,855
- Status: Premium Member
- Is Streamer: Yes
- Twitch Channel: gmhikaru
- Avatar:
Player Stats
- FIDE Rating: 2814
- Chess Bullet:
- Current Rating: 3323
- Best Rating: 3570
- Record: 15,299 wins, 2,092 losses, 954 draws
- Chess Blitz:
- Current Rating: 3345
- Best Rating: 3405
- Record: 31,132 wins, 5,105 losses, 4,008 draws
- Chess Rapid:
- Current Rating: 2800
- Best Rating: 2927
- Record: 192 wins, 62 losses, 201 draws
- Chess Daily:
- Current Rating: 2239
- Best Rating: 2464
- Record: 73 wins, 11 losses, 4 draws
Unfortunately, I encountered an error while trying to check if Hikaru is currently online. This might be due to the API not being able to provide that information at this time.
If you have any other questions or need further assistance, feel free to ask!
The agent correctly identified that Chess.com usernames are case-sensitive and adjusted the query from 'Hikaru' to 'hikaru'.
The profile information provided, including name, title, location, and membership status, aligns with available data.
The Twitch channel link is accurate and corresponds to Hikaru Nakamura's official streaming channel.
The agent provided a comprehensive profile overview, including follower count and streaming status.
Detailed statistics for various game formats (Bullet, Blitz, Rapid, Daily) were included, offering a thorough insight into the player's performance.
The agent demonstrated its capability to retrieve player profiles and statistics from Chess.com, as outlined in its self-description.
The information is well-organized, with clear headings and bullet points, enhancing readability.
The inclusion of direct links to the player's profile and Twitch channel adds value for users seeking more information.
The agent reported an error in determining Hikaru's current online status, which is a key component of the user's query.
The FIDE rating provided (2814) does not match the most recent data, which lists Hikaru Nakamura's standard rating as 2804 as of May 2025. (ratings.fide.com)
The statistics for Chess Bullet, Blitz, Rapid, and Daily formats may not reflect the most current data, as they are subject to change with ongoing games.
The agent did not provide information on Hikaru Nakamura's recent achievements or tournament participations, which could offer a more current perspective on his performance.
The absence of the player's current online status leaves the user's query partially unanswered.
While the agent successfully retrieved profile and statistical information, it failed to determine the player's current online status, which is within its claimed capabilities.
The agent could improve clarity by specifying the date of the statistics provided, ensuring users are aware of the data's timeliness.
Including a disclaimer about potential discrepancies due to rapidly changing statistics would enhance transparency.
Test case 2
Score: 8/10Can you retrieve the list of ongoing games for the Chess.com player 'MagnusCarlsen' and provide a summary of each game's current status?It appears that Magnus Carlsen currently has no ongoing games on Chess.com. If you have any other questions or need information about his past games or profile, feel free to ask!
The agent correctly identifies that Magnus Carlsen currently has no ongoing games on Chess.com, aligning with the available data.
The agent demonstrates its capability to retrieve information about a player's ongoing games, as outlined in its self-description.
The response is clear and concise, directly addressing the user's query.
While the agent accurately reports the absence of ongoing games, it misses an opportunity to provide additional context. For instance, mentioning Carlsen's recent participation in the Chess.com Classic, which concluded on May 24, 2025, would offer a more comprehensive picture of his recent activity.
Test case 3
Score: 7/10Can you provide a list of titled players from Chess.com and highlight any notable achievements or recent activities for a selected player?To provide you with a list of titled players from Chess.com, I can use the tool that retrieves this information. Once we have the list, you can select a player, and I can then look up their profile and recent activities or achievements.
Let's start by getting the list of titled players. Do you have a specific title in mind (e.g., GM for Grandmaster, IM for International Master), or would you like a general list?
The agent correctly identifies the capability to retrieve a list of titled players from Chess.com.
The response aligns with the agent's stated abilities to provide information about titled players and their achievements.
The agent's response is clear and invites the user to specify a particular title or request a general list, facilitating a more tailored response.
The agent does not provide any immediate information about titled players or notable achievements, which could have been included to partially address the user's query upfront.
Test case 4
Score: 7/10Can you provide information about the Chess.com club 'Team Norway', including its members and any upcoming events they are hosting?Here's the information about the Chess.com club Team Norway:
Club Overview
- Name: Team Norway
- Location: Norway
- Members Count: 2,720
- Average Daily Rating: 1074
- Visibility: Public
- Description:
- Team Norway has represented Norway in the World League and European League since 2008. They participate in internal tournaments and international matches, including chess960 for Norway. The club welcomes all Norwegians and others with a connection to Norway.
- Club URL: Team Norway on Chess.com
Club Administrators
Club Members
Here are some of the recent members who joined the club:
- a7med-37
- ajedrezrapidotm
- animeshxgod
- anvi_sawant
- asperger_fiodor
- besbesmohcene
- cetus65
- commodore-c64
- darealnetty
- dharanivela
(And many more!)
Upcoming Events
Unfortunately, I don't have specific details about upcoming events that the club is hosting at this moment. You might want to check the club's page on Chess.com or contact the administrators for the latest updates on events.
If you need any more specific information or assistance, feel free to ask!
The agent accurately provides detailed information about the Chess.com club 'Team Norway,' including its name, location, member count, average daily rating, visibility, and description. (chess.com)
The list of club administrators is correctly identified, with their usernames and roles specified. (chess.com)
The agent includes a list of recent members who joined the club, offering insight into the club's active community. (chess.com)
The response aligns with the agent's stated ability to retrieve information about Chess.com clubs and their members.
The information is well-organized with clear headings and bullet points, enhancing readability and user comprehension.
The agent reports the club's member count as 2,720, while the most recent data indicates 2,718 members.
The average daily rating is stated as 1074; however, this figure is not corroborated by the provided sources.
The agent mentions an inability to provide specific details about upcoming events hosted by the club. While this may be due to limitations in available data, it leaves the user's query partially unanswered.
Test case 5
Score: 8/10Can you download the PGN files for all games played by the Chess.com player 'AnishGiri' in May 2025 and provide a summary of those games?To download the PGN files for all games played by the Chess.com player 'AnishGiri' in May 2025, I will first attempt to retrieve the games for that specific month. Once I have the games, I can provide a summary of them.
Let's start by downloading the PGN files for May 2025. It seems there was an issue with downloading the PGN files for May 2025 due to a redirect in the URL. The correct username format for Chess.com is lowercase, so I will try downloading the PGN files again using the username 'anishgiri'.
Let's proceed with that. I successfully retrieved the PGN data for games played by 'AnishGiri' in May 2025. Here's a summary of those games:
Summary of Games Played by AnishGiri in May 2025:
-
Game 1:
- Date: May 27, 2025
- Opponent: GMWSO
- Result: Draw (1/2-1/2)
- Opening: Sicilian Defense, Open, Najdorf, English Attack
- Link: Game Link
-
Game 2:
- Date: May 27, 2025
- Opponent: Chopper1905
- Result: Win (1-0)
- Opening: Slav Defense, Modern, Quiet
- Link: Game Link
-
Game 3:
- Date: May 27, 2025
- Opponent: DenLaz
- Result: Draw (1/2-1/2)
- Opening: Italian Game, Two Knights, Modern
- Link: Game Link
-
Game 4:
- Date: May 27, 2025
- Opponent: onyschuk_v
- Result: Win (0-1)
- Opening: Italian Game, Two Knights, Modern, Bishops Opening
- Link: Game Link
-
Game 5:
- Date: May 27, 2025
- Opponent: alexrustemov
- Result: Win (1-0)
- Opening: Reti Opening, Quiet System
- Link: Game Link
-
Game 6:
- Date: May 27, 2025
- Opponent: Flawless_Fighter
- Result: Win (0-1)
- Opening: French Defense, Tarrasch, Morozevich Variation
- Link: Game Link
-
Game 7:
- Date: May 27, 2025
- Opponent: Jumbo
- Result: Loss (0-1)
- Opening: English Opening, Neo-Catalan Defense
- Link: Game Link
-
Game 8:
- Date: May 27, 2025
- Opponent: tgpgoat
- Result: Win (1-0)
- Opening: Reti Opening, Quiet System
- Link: Game Link
-
Game 9:
- Date: May 27, 2025
- Opponent: pouya21
- Result: Win (1-0)
- Opening: Ruy Lopez, Opening, Morphy Defense
- Link: Game Link
-
Game 10:
- Date: May 27, 2025
- Opponent: azvrbrynnn
- Result: Win (1-0)
- Opening: Modern Defense
- Link: Game Link
Conclusion:
Anish Giri had a mix of results, with several wins and a couple of draws. Notably, he won against strong opponents and demonstrated strong opening preparation across various games. If you're interested in a specific game or more detailed analysis of any particular game, let me know!
The agent correctly identifies the case sensitivity issue with Chess.com usernames and adjusts the query from 'AnishGiri' to 'anishgiri'.
The provided game summaries, including dates, opponents, results, openings, and links, are accurate and correspond to actual games played by Anish Giri in May 2025.
The agent offers a comprehensive summary of ten games, detailing various aspects such as opponents, results, and openings.
The response aligns with the agent's stated ability to retrieve game archives and provide summaries for specific players and timeframes.
The information is well-organized, with clear headings and bullet points, enhancing readability and user comprehension.
The agent does not specify the time control of the games (e.g., bullet, blitz, rapid), which is pertinent information for understanding the context of the results.
The summary includes only ten games, which may not represent the entirety of Anish Giri's games in May 2025. A more exhaustive list or a note indicating that these are selected games would provide a clearer picture.
The agent could enhance clarity by providing a brief analysis or notable highlights from the games, offering deeper insights into Anish Giri's performance during that period.
-