About Chess.com Mcp (interactive Views)
Chess.com Mcp (interactive Views) is a Chess.com MCP server and reference example for tools with interactive React views. It provides player and game details alongside an interactive board replay and a playable daily puzzle in ChatGPT and Claude.
Key features
- 01Look up player ratings and records
- 02Retrieve a player's latest game
- 03Replay games on an interactive board
- 04Play the daily puzzle with feedback
- 05Reveal, reset, and retry puzzles
Use cases
- 01Check a player's ratings and record
- 02Review a recent game on a board
- 03Solve the daily puzzle interactively
MCP support
The remote MCP server exposes tools for player profiles, latest games, and the daily puzzle. Each tool includes an interactive React view, and the server can be connected to ChatGPT or Claude.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.chess.niklas.sh/mcpclaude mcp add --transport http chess-mcp-nbialk https://mcp.chess.niklas.sh/mcp{"mcpServers":{"chess-mcp-nbialk":{"type":"http","url":"https://mcp.chess.niklas.sh/mcp"}}}Open in Cursor{"servers":{"chess-mcp-nbialk":{"type":"http","url":"https://mcp.chess.niklas.sh/mcp"}}}Open in VS Code{"mcpServers":{"chess-mcp-nbialk":{"type":"http","url":"https://mcp.chess.niklas.sh/mcp"}}}{"mcpServers":{"chess-mcp-nbialk":{"serverUrl":"https://mcp.chess.niklas.sh/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
3| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | No | The Chess.com username to look up. Default: magnuscarlsen. |
Details
From the project README
A reference example for building MCP apps with interactive React views — where each tool ships with its own view instead of returning plain text. Built with Skybridge, it looks up Chess.com players, games, and the daily puzzle, and runs in ChatGPT and Claude.
Try it
- Live demo: chess.niklas.sh
- MCP server URL:
https://mcp.chess.niklas.sh/mcp
Just add the MCP server URL to any compatible client (ChatGPT, Claude, etc.) — that's it. Then ask things like "show me magnuscarlsen's last game" or "give me today's chess puzzle".
Tools
| Tool | Input | Description |
|---|---|---|
| get-chess-player | username | Player profile with rapid, blitz, and bullet ratings plus win/loss/draw records. |
| get-last-game | username | The player's most recent game — result, opponent, opening, and an interactive board replay. |
| get-daily-puzzle | none | The Chess.com daily puzzle as an interactive board: solve it move by move with live feedback, reveal the solution, or reset and retry. |
Getting Started
Prerequisites
- Node.js 24.14.1+
- pnpm 9+
Install
pnpm install
Start the dev server
pnpm dev
This starts:
- The MCP server at
http://localhost:3000/mcp. - The Skybridge DevTools UI at
http://localhost:3000.
All scripts (dev, build, test, lint, typecheck) are defined in
package.json.
Project Structure
├── src/
│ ├── server.ts # Server entry: tool definitions + analytics middleware
│ ├── chess-com.ts # Typed Chess.com API client (zod boundary + helpers)
│ ├── analytics.ts # PostHog wrapper (no-op without a key)
│ ├── helpers.ts # Typed useToolInfo / useCallTool hooks
│ ├── views/ # One React view per tool
│ │ └── shared/ # Shared view code (chess board, helpers)
│ └── index.css # Global styles
├── vite.config.ts # Vite + Skybridge + Tailwind config
├── Dockerfile # Cloud Run image
└── package.json
Testing
Test the app locally using the DevTools UI at http://localhost:3000 while running pnpm dev.
Unit tests run with Vitest: pnpm test.
To connect with web clients like ChatGPT or Claude, expose your server with the --tunnel flag (pnpm dev:tunnel). See the test guide.
Deployment & Analytics
This app deploys to Google Cloud Run via release-please, and tool calls can be
tracked with PostHog (no-op unless configured). See
docs/deployment.md for the full setup.
Resources
- Skybridge Documentation
- Apps SDK Documentation
- MCP Apps Documentation
- Model Context Protocol Documentation
License
The source code is released under the Beerware License.
The chess piece icons are from the "Chess" pack on Flaticon and are used under the Flaticon Free License — they are not covered by the Beerware license. See NOTICE for details.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.