Chess.com API and MCP server for AI agents

Let Claude, ChatGPT or your own agent read Chess.com. No Chess.com API key needed.

Add to your agent

Paste this into Claude Code, Cursor, Codex or any agent. It adds the server itself.

Read https://bowmark.ai/sites/chess_com.md and add Bowmark's Chess.com MCP server to my agent.

Functions

Open a function to see its parameters and run it with your own API key.

  • getDailyPuzzleReads today's daily puzzle: title, FEN, PGN solution, image and URL.

    POST /v1/sites/chess_com/getDailyPuzzle

    Parameters

    No parameters.

    curl -X POST https://api.bowmark.ai/v1/sites/chess_com/getDailyPuzzle \
      -H "Authorization: Bearer $BOWMARK_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{}'
    Sign in to run
    Responsereturns chess_comPuzzle
    interface chess_comPuzzle {
      title: string;
      url: string | null;
      fen: string;
      pgn: string | null; // the solution
      imageUrl: string | null;
      publishedAt: string | null;
    }
  • getLeaderboardsReads the top-50 leaderboards for each game type, puzzles and Puzzle Rush.

    POST /v1/sites/chess_com/getLeaderboards

    Parameters

    curl -X POST https://api.bowmark.ai/v1/sites/chess_com/getLeaderboards \
      -H "Authorization: Bearer $BOWMARK_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"args":{}}'
    Sign in to run
    Responsereturns chess_comLeaderboard[]
    interface chess_comLeaderRow {
      rank: number | null;
      username: string;
      score: number | null;
      title: string | null;
      country: string | null;
      url: string | null;
    }
    
    interface chess_comLeaderboard {
      category: string; // "live_blitz", "daily", "tactics", …
      players: chess_comLeaderRow[];
    }
  • getPlayerReads a Chess.com player profile: name, title, country, avatar, join date, last online, followers, status.

    POST /v1/sites/chess_com/getPlayer

    Parameters

    curl -X POST https://api.bowmark.ai/v1/sites/chess_com/getPlayer \
      -H "Authorization: Bearer $BOWMARK_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"args":{"username":"hikaru"}}'
    Sign in to run
    Responsereturns chess_comPlayer
    interface chess_comPlayer {
      username: string;
      playerId: number | null;
      name: string | null;
      title: string | null; // "GM", "IM", … or null
      url: string | null;
      avatarUrl: string | null;
      country: string | null; // ISO code, e.g. "US"
      location: string | null;
      followers: number | null;
      status: string | null; // "basic", "premium", "closed", …
      league: string | null;
      isStreamer: boolean;
      twitchUrl: string | null;
      joined: string | null; // ISO instant
      lastOnline: string | null;
    }
  • getPlayerStatsReads a player's current and best ratings and win/loss/draw record for bullet, blitz, rapid, daily, puzzles and Puzzle Rush.

    POST /v1/sites/chess_com/getPlayerStats

    Parameters

    curl -X POST https://api.bowmark.ai/v1/sites/chess_com/getPlayerStats \
      -H "Authorization: Bearer $BOWMARK_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"args":{"username":"hikaru"}}'
    Sign in to run
    Responsereturns chess_comRating[]
    interface chess_comRating {
      mode: string; // "chess_rapid", "chess_blitz", "tactics", "puzzle_rush", …
      rating: number | null;
      ratingDeviation: number | null;
      lastPlayed: string | null;
      bestRating: number | null;
      bestGameUrl: string | null;
      wins: number | null;
      losses: number | null;
      draws: number | null;
    }