`top_players`

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

Lichess leaderboard for a single chess variant: the highest-rated Lichess accounts in one perf (bullet, blitz, rapid, classical, correspondence, chess960, crazyhouse, atomic, antichess, horde, kingOfTheHill, racingKings, threeCheck, ultraBullet), up to 200 entries. Returns each player username, title, and current rating in that variant. Answers who the top-rated blitz or bullet players on Lichess are right now.

Parameters

Name	Type	Required	Description
`perf`	string	yes
`limit`	number	no	1-200 (default 50)

Example call

Arguments

{
  "perf": "blitz"
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('top_players', {
  "perf": "blitz"
});

More examples

{
  "perf": "bullet",
  "limit": 100
}

Response shape

Always returns: items, count

Field	Type	Description
`items`	array
`count`	integer	Number of items returned.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "User ID"
          },
          "username": {
            "type": "string",
            "description": "Username"
          },
          "title": {
            "type": "string",
            "description": "Title"
          },
          "rating": {
            "type": "number",
            "description": "Rating"
          },
          "games": {
            "type": "number",
            "description": "Games played"
          },
          "score": {
            "type": "number",
            "description": "Score"
          },
          "rd": {
            "type": "number",
            "description": "Rating deviation"
          },
          "prog": {
            "type": "number",
            "description": "Progress"
          }
        }
      }
    },
    "count": {
      "type": "integer",
      "description": "Number of items returned."
    }
  },
  "required": [
    "items",
    "count"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

top_players