naftiko: 1.0.0-alpha2
info:
  label: Chess.com Published Data API - Clubs
  description: Club profile, members by activity level, and team match list.
  tags:
  - Chess.com
  - Clubs
  created: '2026-05-25'
  modified: '2026-05-25'
binds: []
capability:
  consumes:
  - type: http
    namespace: clubs-clubs
    baseUri: https://api.chess.com/pub
    description: Chess.com Clubs surface.
    resources:
    - name: club
      path: /club/{url-ID}
      operations:
      - name: getclub
        method: GET
        description: Get Club Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: club-members
      path: /club/{url-ID}/members
      operations:
      - name: getclubmembers
        method: GET
        description: Get Club Members
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: club-matches
      path: /club/{url-ID}/matches
      operations:
      - name: getclubmatches
        method: GET
        description: Get Club Matches
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: none
  exposes:
  - type: rest
    namespace: clubs-clubs-rest
    port: 8080
    description: REST adapter for Chess.com Clubs.
    resources:
    - path: /v1/club/{url-ID}
      name: club
      operations:
      - method: GET
        name: getclub
        description: Get Club Profile
        call: clubs-clubs.getclub
    - path: /v1/club/{url-ID}/members
      name: club-members
      operations:
      - method: GET
        name: getclubmembers
        description: Get Club Members
        call: clubs-clubs.getclubmembers
    - path: /v1/club/{url-ID}/matches
      name: club-matches
      operations:
      - method: GET
        name: getclubmatches
        description: Get Club Matches
        call: clubs-clubs.getclubmatches
  - type: mcp
    namespace: clubs-clubs-mcp
    port: 9090
    transport: http
    description: MCP adapter for Chess.com Clubs.
    tools:
    - name: chesscom-get-club
      description: Get Club Profile
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: clubs-clubs.getclub
    - name: chesscom-get-club-members
      description: Get Club Members
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: clubs-clubs.getclubmembers
    - name: chesscom-get-club-matches
      description: Get Club Matches
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: clubs-clubs.getclubmatches