`user`

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

Fetch a Lichess player’s public profile by username, including ratings across all variants (bullet, blitz, rapid, classical, chess960, etc.) and account metadata.

Parameters

Name	Type	Required	Description
`username`	string	yes

Example call

Arguments

{
  "username": "hikaru"
}

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":"user","arguments":{"username":"hikaru"}}}'

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "username": "magnuschess"
}

Response shape

Field	Type	Description
`id`	string	User ID
`username`	string	Username
`title`	string	Title (GM, IM, FM, etc.)
`online`	boolean	Online status
`perfs`	object	Performance ratings across variants
`createdAt`	number	Timestamp
`seenAt`	number	Last seen timestamp

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "username": {
      "type": "string",
      "description": "Username"
    },
    "title": {
      "type": "string",
      "description": "Title (GM, IM, FM, etc.)"
    },
    "online": {
      "type": "boolean",
      "description": "Online status"
    },
    "perfs": {
      "type": "object",
      "description": "Performance ratings across variants",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "rating": {
            "type": "number",
            "description": "Rating"
          },
          "rd": {
            "type": "number",
            "description": "Rating deviation"
          },
          "prog": {
            "type": "number",
            "description": "Progress"
          },
          "prov": {
            "type": "boolean",
            "description": "Provisional"
          }
        }
      }
    },
    "createdAt": {
      "type": "number",
      "description": "Timestamp"
    },
    "seenAt": {
      "type": "number",
      "description": "Last seen timestamp"
    }
  }
}

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.

user