chesscom-mcp
Enables querying Chess.com public data including player profiles, stats, games, and club information through natural language.
README
chesscom-mcp
An MCP server over the Chess.com public data API. Read-only, and the upstream API needs no authentication — there is no token to manage and nothing to expire, which makes this the simplest of the set.
Runs over stdio and is registered in ~/.claude.json as chesscom.
Tools
| Tool | Purpose |
|---|---|
chess_get_profile |
Public profile — name, title, country, followers, join date |
chess_get_stats |
Ratings and W/L/D per format (bullet, blitz, rapid, daily, puzzles) |
chess_get_current_games |
Daily/correspondence games in progress; onlyMyTurn filters to games awaiting a move |
chess_get_game_archives |
Index of available monthly archive URLs for a player |
chess_get_games_by_month |
Every game a player played in a given year/month, with PGNs |
chess_get_titled_players |
Usernames holding a given title (GM, IM, FM, …) |
chess_get_leaderboards |
Current Chess.com leaderboards across all categories |
chess_get_club |
Club profile by URL-ID |
chess_get_clubs |
Clubs a given player belongs to |
Layout
src/client.js thin fetch wrapper over api.chess.com/pub, shared error handling
src/chess.js all nine tool registrations
src/index.js McpServer construction + stdio transport
Running it
npm ci
npm start # stdio server; expects an MCP client on the other end
Registered for Claude Code with:
claude mcp add chesscom -- node <path>/chesscom-mcp/src/index.js
Tests
npm test
Registration plus the fetch wrapper's URL, headers and error handling, using a
stubbed fetch. No network calls, so it is safe in CI.
Notes
- The upstream API is rate-limited but generous, and serves cached responses.
Bursts of
chess_get_games_by_monthacross many months are the realistic way to hit a limit. - Usernames are case-insensitive upstream but are URL-encoded here before use.
credentials/and.envare gitignored on principle even though this server has no secrets today — so that adding auth later can't leak one by accident.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.