Skip to main content
Glama
Sign In
Chess-com MCP (interactive views)

Chess-com MCP (interactive views)

by nbialk
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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

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".

Related MCP server: Chess MCP Server

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

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • ChessAgine MCP

      jalpp
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables comprehensive chess analysis through Stockfish engine integration, positional evaluation, puzzle training, game review, and access to extensive chess databases. Provides visual board rendering, interactive game viewers, and tactical puzzle training with 3+ million problems from Lichess.
      34
      AGPL 3.0

    • Chess MCP Server

      bhayanak
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to explore player profiles, ratings, game archives, leaderboards, clubs, and puzzles via the Chess.com API.
      2
      MIT

    • Chess.com MCP Server

      piperap
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to query Chess.com's public API for player profiles, stats, game archives, online status, clubs, and titled players, and to download game PGNs.
      MIT