chess.com MCP server
Player ratings and records from chess.com. Add one address to your AI assistant and it can call the tool below itself, with your FoxAPIs key. It costs the same credits as the REST API, and an answer with no data is not charged.
Server address
https://foxapis.com/mcp/data/chess
Streamable HTTP, bearer key in the Authorization header. This address carries only the chess.com tool; https://foxapis.com/mcp/data carries all of them, and ?source=chess,github picks several.
What you can ask
Five prompts to give your assistant once the server is added:
- What are Hikaru's chess.com ratings in blitz and bullet?
- What is the puzzle rush best of the chess.com player hikaru?
- What title and country does the chess.com player hikaru have?
- Compare the rapid ratings of two chess.com players I name.
- Is the chess.com user I name a titled player, and when were they last online?
The tool your assistant gets
| Tool | What it returns | Inputs | Credits a call |
|---|---|---|---|
chess_player | A chess.com player: ratings per time control, title, country, followers, puzzle and tactics ratings and last online date, by user name. | username (required) | 1 |
Credits come from the same file as the pricing page. Plans and top-ups are on pricing.
Set it up
Use your FoxAPIs key (it starts with fxp_) as the bearer token. Get one free at foxapis.com/trial.
Claude Code
Run in a terminal. Its docs.
claude mcp add --transport http foxapis-data https://foxapis.com/mcp/data/chess \ --header "Authorization: Bearer YOUR_KEY"
The Claude Code docs show this form (--transport http, name, URL, --header) for a server that takes a bearer token.
Cursor
.cursor/mcp.json in a project, or ~/.cursor/mcp.json for every project. Its docs.
{
"mcpServers": {
"foxapis-data": {
"url": "https://foxapis.com/mcp/data/chess",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Cursor's remote-server example uses a url and a headers object.
VS Code (Copilot)
.mcp.json at the workspace root, or ~/.copilot/mcp-config.json. Its docs.
{
"mcpServers": {
"foxapis-data": {
"type": "http",
"url": "https://foxapis.com/mcp/data/chess",
"headers": {
"Authorization": "Bearer YOUR_KEY"
},
"tools": [
"*"
]
}
}
}Do not store a real key in a file you share.
Cline
cline_mcp_settings.json (open it from Cline's MCP Servers panel). Its docs.
{
"mcpServers": {
"foxapis-data": {
"type": "streamableHttp",
"url": "https://foxapis.com/mcp/data/chess",
"headers": {
"Authorization": "Bearer YOUR_KEY"
},
"disabled": false,
"autoApprove": []
}
}
}Cline's docs say that leaving type out selects the older SSE transport, so keep type.
Zed
settings.json (Zed: open settings). Its docs.
{
"context_servers": {
"foxapis-data": {
"url": "https://foxapis.com/mcp/data/chess",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}
n8n
an MCP Client Tool node in a workflow. Its docs.
Endpoint: https://foxapis.com/mcp/data/chess Server transport: HTTP Streamable Authentication: Header Auth Name: Authorization Value: Bearer YOUR_KEY
Not run by us: the fields are the ones n8n's MCP Client Tool documents. The server speaks Streamable HTTP.
Claude Desktop and ChatGPT
Not covered here: their custom-connector screens ask for sign-in (OAuth) or no authentication, and this server takes a bearer key in a header, so it works best in the clients above. We have not tested it in either.
A real answer
The chess_player tool called once through a real MCP client session on 20 November 2026 with the input {"username":"hikaru"}. Long text is cut and lists are cut to three items for display; it is not invented.
{
"platform": "chess.com",
"username": "hikaru",
"title": "GM",
"name": "Hikaru Nakamura",
"country": "US",
"location": "Florida",
"joined_date": "2014-01-06",
"last_online": "2026-11-20",
"is_streamer": true,
"verified": false,
"league": "Legend",
"followers": 1436362,
"bullet": {
"current_rating": 3402,
"best_rating": 3570,
"best_game_url": "https://www.chess.com/game/live/5710095242",
"wins": 17334,
"losses": 2562,
"draws": 1197,
"total_games": 21093,
"last_game_date": "2026-11-16"
},
"blitz": {
"current_rating": 3465,
"best_rating": 3503,
"best_game_url": "https://www.chess.com/game/live/184580310677",
"wins": 36259,
"losses": 5573,
"draws": 4397,
"total_games": 46229,
"last_game_date": "2026-11-19"
},
"rapid": {
"current_rating": 2838,
"best_rating": 2927,
"best_game_url": "https://www.chess.com/game/live/141332265952",
"wins": 205,
"losses": 69,
"draws": 220,
"total_games": 494,
"last_game_date": "2026-08-15"
},
"daily": {
"current_rating": 2239,
"best_rating": 2464,
"best_game_url": "https://www.chess.com/game/daily/84604826",
"wins": 73,
"losses": 11,
"draws": 4,
"total_games": 88,
"last_game_date": "2026-02-08"
},
"chess960_daily": {
"current_rating": 1231,
"best_rating": 1489,
"best_game_url": "https://www.chess.com/game/daily/87191830",
"wins": 1,
"losses": 2,
"draws": 0,
"total_games": 3,
"last_game_date": "2015-10-10"
},
"tactics_rating": 2730,
"puzzle_rush_best": 123,
"profile_url": "https://www.chess.com/member/Hikaru",
"avatar": "https://images.chesscomfiles.com/uploads/v1/user/15448422.88c010c1.200x200o.3c5619f5441e.png",
"time_controls_glossary": {
"bullet": "1-2 minutes per game",
"blitz": "3-5 minutes per game",
"rapid": "10-25 minutes per game",
"daily": "1-14 days per move (correspondence chess)"
},
"credits_used": 1,
"latency_ms": 169
}
Charged: 1 credit.
Try it free
Runs the chess_player call with the sample input below. No key and no sign-up; a few runs a day per visitor.
{
"username": "hikaru"
}
Other data-source MCP servers
Lichess · Shopify stores · YouTube · Substack · Bluesky · Mastodon · all of them
Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.
Get my free keyThe same data over REST: chess.com player. More: all MCP servers · people and company tools