`top_players`

Pack: lichess · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/top_players for the schema, then POST the same URL with its arguments for the data.

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

Field	Type	Description
`users`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "users": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "username": {
            "type": "string"
          },
          "perfs": {
            "type": "object",
            "properties": {
              "blitz": {
                "type": "object",
                "properties": {
                  "rating": {
                    "type": "number"
                  },
                  "progress": {
                    "type": "number"
                  }
                }
              },
              "bullet": {
                "type": "object",
                "properties": {
                  "rating": {
                    "type": "number"
                  },
                  "progress": {
                    "type": "number"
                  }
                }
              }
            }
          },
          "title": {
            "type": "string"
          },
          "online": {
            "type": "boolean"
          },
          "patron": {
            "type": "boolean"
          },
          "patronColor": {
            "type": "number"
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the lichess pack

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

See Getting Started for client-specific install steps.

top_players