Chess.com · Capability

Chess.com Published Data API - Countries

Country profile and per-country rosters of players and clubs.

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

The capability includes 3 read-only operations. Lead operation: Get Country Profile. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Chess.com and Countries.

Run with Naftiko Chess.comCountries

What You Can Do

GET
Getcountry — Get Country Profile
/v1/country/{iso}
GET
Listcountryplayers — List Players By Country
/v1/country/{iso}/players
GET
Listcountryclubs — List Clubs By Country
/v1/country/{iso}/clubs

MCP Tools

chesscom-get-country

Get Country Profile

read-only idempotent
chesscom-list-country-players

List Players By Country

read-only idempotent
chesscom-list-country-clubs

List Clubs By Country

read-only idempotent

Capability Spec

countries-countries.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: Chess.com Published Data API - Countries
  description: Country profile and per-country rosters of players and clubs.
  tags:
  - Chess.com
  - Countries
  created: '2026-05-25'
  modified: '2026-05-25'
binds: []
capability:
  consumes:
  - type: http
    namespace: countries-countries
    baseUri: https://api.chess.com/pub
    description: Chess.com Countries surface.
    resources:
    - name: country
      path: /country/{iso}
      operations:
      - name: getcountry
        method: GET
        description: Get Country Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: country-players
      path: /country/{iso}/players
      operations:
      - name: listcountryplayers
        method: GET
        description: List Players By Country
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: country-clubs
      path: /country/{iso}/clubs
      operations:
      - name: listcountryclubs
        method: GET
        description: List Clubs By Country
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: none
  exposes:
  - type: rest
    namespace: countries-countries-rest
    port: 8080
    description: REST adapter for Chess.com Countries.
    resources:
    - path: /v1/country/{iso}
      name: country
      operations:
      - method: GET
        name: getcountry
        description: Get Country Profile
        call: countries-countries.getcountry
    - path: /v1/country/{iso}/players
      name: country-players
      operations:
      - method: GET
        name: listcountryplayers
        description: List Players By Country
        call: countries-countries.listcountryplayers
    - path: /v1/country/{iso}/clubs
      name: country-clubs
      operations:
      - method: GET
        name: listcountryclubs
        description: List Clubs By Country
        call: countries-countries.listcountryclubs
  - type: mcp
    namespace: countries-countries-mcp
    port: 9090
    transport: http
    description: MCP adapter for Chess.com Countries.
    tools:
    - name: chesscom-get-country
      description: Get Country Profile
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: countries-countries.getcountry
    - name: chesscom-list-country-players
      description: List Players By Country
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: countries-countries.listcountryplayers
    - name: chesscom-list-country-clubs
      description: List Clubs By Country
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: countries-countries.listcountryclubs