Chess.com · Capability

Chess.com Published Data API - Games

Daily, live, current, to-move, and archived monthly games with PGN download.

Chess.com Published Data API - Games is a Naftiko capability published by Chess.com, one of 9 capabilities the APIs.io network indexes for this provider. It bundles 5 operations across the GET method rooted at /v1/player/{…}/games.

The capability includes 5 read-only operations. Lead operation: Get Player Current Daily Games. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Chess.com, Games, and PGN.

Run with Naftiko Chess.comGamesPGN

What You Can Do

GET

Getplayercurrentgames — Get Player Current Daily Games

/v1/player/{username}/games

GET

Getplayergamestomove — Get Player Games To Move

/v1/player/{username}/games/to-move

GET

Listplayerarchives — List Player Game Archives

/v1/player/{username}/games/archives

GET

Getplayermonthlyarchive — Get Player Monthly Archive

/v1/player/{username}/games/{year}/{month}

GET

Getplayermonthlyarchivepgn — Get Player Monthly Archive PGN

/v1/player/{username}/games/{year}/{month}/pgn

MCP Tools

chesscom-get-current-games

Get Player Current Daily Games

read-only idempotent

chesscom-get-games-to-move

Get Player Games To Move

read-only idempotent

chesscom-list-archives

List Player Game Archives

read-only idempotent

chesscom-get-monthly-archive

Get Player Monthly Archive

read-only idempotent

chesscom-get-monthly-archive-pgn

Get Player Monthly Archive PGN

read-only idempotent

Capability Spec

naftiko: 1.0.0-alpha2
info:
  label: Chess.com Published Data API - Games
  description: Daily, live, current, to-move, and archived monthly games with PGN download.
  tags:
  - Chess.com
  - Games
  - PGN
  created: '2026-05-25'
  modified: '2026-05-25'
binds: []
capability:
  consumes:
  - type: http
    namespace: games-games
    baseUri: https://api.chess.com/pub
    description: Chess.com Games surface.
    resources:
    - name: player-games
      path: /player/{username}/games
      operations:
      - name: getplayercurrentgames
        method: GET
        description: Get Player Current Daily Games
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: player-games-to-move
      path: /player/{username}/games/to-move
      operations:
      - name: getplayergamestomove
        method: GET
        description: Get Player Games To Move
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: player-games-archives
      path: /player/{username}/games/archives
      operations:
      - name: listplayerarchives
        method: GET
        description: List Player Game Archives
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: player-games-month
      path: /player/{username}/games/{year}/{month}
      operations:
      - name: getplayermonthlyarchive
        method: GET
        description: Get Player Monthly Archive
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: player-games-month-pgn
      path: /player/{username}/games/{year}/{month}/pgn
      operations:
      - name: getplayermonthlyarchivepgn
        method: GET
        description: Get Player Monthly Archive PGN
        outputRawFormat: text
        outputParameters:
        - name: result
          type: string
          value: $.
    authentication:
      type: none
  exposes:
  - type: rest
    namespace: games-games-rest
    port: 8080
    description: REST adapter for Chess.com Games.
    resources:
    - path: /v1/player/{username}/games
      name: player-games
      operations:
      - method: GET
        name: getplayercurrentgames
        description: Get Player Current Daily Games
        call: games-games.getplayercurrentgames
    - path: /v1/player/{username}/games/to-move
      name: player-games-to-move
      operations:
      - method: GET
        name: getplayergamestomove
        description: Get Player Games To Move
        call: games-games.getplayergamestomove
    - path: /v1/player/{username}/games/archives
      name: player-games-archives
      operations:
      - method: GET
        name: listplayerarchives
        description: List Player Game Archives
        call: games-games.listplayerarchives
    - path: /v1/player/{username}/games/{year}/{month}
      name: player-games-month
      operations:
      - method: GET
        name: getplayermonthlyarchive
        description: Get Player Monthly Archive
        call: games-games.getplayermonthlyarchive
    - path: /v1/player/{username}/games/{year}/{month}/pgn
      name: player-games-month-pgn
      operations:
      - method: GET
        name: getplayermonthlyarchivepgn
        description: Get Player Monthly Archive PGN
        call: games-games.getplayermonthlyarchivepgn
  - type: mcp
    namespace: games-games-mcp
    port: 9090
    transport: http
    description: MCP adapter for Chess.com Games.
    tools:
    - name: chesscom-get-current-games
      description: Get Player Current Daily Games
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: games-games.getplayercurrentgames
    - name: chesscom-get-games-to-move
      description: Get Player Games To Move
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: games-games.getplayergamestomove
    - name: chesscom-list-archives
      description: List Player Game Archives
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: games-games.listplayerarchives
    - name: chesscom-get-monthly-archive
      description: Get Player Monthly Archive
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: games-games.getplayermonthlyarchive
    - name: chesscom-get-monthly-archive-pgn
      description: Get Player Monthly Archive PGN
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: games-games.getplayermonthlyarchivepgn