`get_stats`

Pack: chess · Endpoint: https://gateway.pipeworx.io/chess/mcp

Get a player’s ratings and game records across daily, rapid, blitz, and bullet formats. Returns current/best ratings and win/loss/draw counts.

Parameters

Name	Type	Required	Description
`username`	string	yes	Chess.com username

Example call

Arguments

{
  "username": "hikaru"
}

curl

curl -X POST https://gateway.pipeworx.io/chess/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_stats","arguments":{"username":"hikaru"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_stats', {
  "username": "hikaru"
});

More examples

{
  "username": "magnuscarlsen"
}

Response shape

Always returns: username, fide, daily, rapid, blitz, bullet, daily_960

Field	Type	Description
`username`	string	Chess.com username
`fide`	number \| null	FIDE rating if available
`daily`	object \| null
`rapid`	object \| null
`blitz`	object \| null
`bullet`	object \| null
`daily_960`	object \| null

Full JSON Schema

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "Chess.com username"
    },
    "fide": {
      "type": [
        "number",
        "null"
      ],
      "description": "FIDE rating if available"
    },
    "daily": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "current_rating": {
          "type": [
            "number",
            "null"
          ],
          "description": "Current rating in daily format"
        },
        "best_rating": {
          "type": [
            "number",
            "null"
          ],
          "description": "Best rating achieved in daily format"
        },
        "record": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "win": {
              "type": "number",
              "description": "Number of wins"
            },
            "loss": {
              "type": "number",
              "description": "Number of losses"
            },
            "draw": {
              "type": "number",
              "description": "Number of draws"
            }
          }
        }
      }
    },
    "rapid": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "current_rating": {
          "type": [
            "number",
            "null"
          ],
          "description": "Current rating in rapid format"
        },
        "best_rating": {
          "type": [
            "number",
            "null"
          ],
          "description": "Best rating achieved in rapid format"
        },
        "record": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "win": {
              "type": "number",
              "description": "Number of wins"
            },
            "loss": {
              "type": "number",
              "description": "Number of losses"
            },
            "draw": {
              "type": "number",
              "description": "Number of draws"
            }
          }
        }
      }
    },
    "blitz": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "current_rating": {
          "type": [
            "number",
            "null"
          ],
          "description": "Current rating in blitz format"
        },
        "best_rating": {
          "type": [
            "number",
            "null"
          ],
          "description": "Best rating achieved in blitz format"
        },
        "record": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "win": {
              "type": "number",
              "description": "Number of wins"
            },
            "loss": {
              "type": "number",
              "description": "Number of losses"
            },
            "draw": {
              "type": "number",
              "description": "Number of draws"
            }
          }
        }
      }
    },
    "bullet": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "current_rating": {
          "type": [
            "number",
            "null"
          ],
          "description": "Current rating in bullet format"
        },
        "best_rating": {
          "type": [
            "number",
            "null"
          ],
          "description": "Best rating achieved in bullet format"
        },
        "record": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "win": {
              "type": "number",
              "description": "Number of wins"
            },
            "loss": {
              "type": "number",
              "description": "Number of losses"
            },
            "draw": {
              "type": "number",
              "description": "Number of draws"
            }
          }
        }
      }
    },
    "daily_960": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "current_rating": {
          "type": [
            "number",
            "null"
          ],
          "description": "Current rating in daily 960 format"
        },
        "best_rating": {
          "type": [
            "number",
            "null"
          ],
          "description": "Best rating achieved in daily 960 format"
        },
        "record": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "win": {
              "type": "number",
              "description": "Number of wins"
            },
            "loss": {
              "type": "number",
              "description": "Number of losses"
            },
            "draw": {
              "type": "number",
              "description": "Number of draws"
            }
          }
        }
      }
    }
  },
  "required": [
    "username",
    "fide",
    "daily",
    "rapid",
    "blitz",
    "bullet",
    "daily_960"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "chess": {
      "url": "https://gateway.pipeworx.io/chess/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_stats