`tablebase`

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

Syzygy tablebase lookup (≤7 pieces). Variant: standard (default), atomic, antichess.

Parameters

Name	Type	Required	Description
`fen`	string	yes
`variant`	string	no	standard \| atomic \| antichess

Example call

Arguments

{
  "fen": "8/8/8/4k3/8/8/4K3/8 w - - 0 1"
}

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":"tablebase","arguments":{"fen":"8/8/8/4k3/8/8/4K3/8 w - - 0 1"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('tablebase', {
  "fen": "8/8/8/4k3/8/8/4K3/8 w - - 0 1"
});

More examples

{
  "fen": "8/8/8/4k3/8/8/4K3/8 w - - 0 1",
  "variant": "atomic"
}

Response shape

Field	Type	Description
`fen`	string	Position FEN
`bestMoves`	array	Best moves in UCI notation
`dtz`	number	Distance to zero (draw/mate)
`dtm`	number	Distance to mate
`checkmate`	boolean	Position is checkmate
`stalemate`	boolean	Position is stalemate
`variant_win`	boolean	Variant-specific win
`variant_loss`	boolean	Variant-specific loss
`insufficient_material`	boolean	Insufficient material
`moves`	array	Legal moves and their outcomes

Full JSON Schema

{
  "type": "object",
  "properties": {
    "fen": {
      "type": "string",
      "description": "Position FEN"
    },
    "bestMoves": {
      "type": "array",
      "description": "Best moves in UCI notation",
      "items": {
        "type": "string"
      }
    },
    "dtz": {
      "type": "number",
      "description": "Distance to zero (draw/mate)"
    },
    "dtm": {
      "type": "number",
      "description": "Distance to mate"
    },
    "checkmate": {
      "type": "boolean",
      "description": "Position is checkmate"
    },
    "stalemate": {
      "type": "boolean",
      "description": "Position is stalemate"
    },
    "variant_win": {
      "type": "boolean",
      "description": "Variant-specific win"
    },
    "variant_loss": {
      "type": "boolean",
      "description": "Variant-specific loss"
    },
    "insufficient_material": {
      "type": "boolean",
      "description": "Insufficient material"
    },
    "moves": {
      "type": "array",
      "description": "Legal moves and their outcomes",
      "items": {
        "type": "object",
        "properties": {
          "uci": {
            "type": "string",
            "description": "Move in UCI notation"
          },
          "san": {
            "type": "string",
            "description": "Move in SAN notation"
          },
          "dtz": {
            "type": "number",
            "description": "DTZ after move"
          },
          "dtm": {
            "type": "number",
            "description": "DTM after move"
          },
          "checkmate": {
            "type": "boolean",
            "description": "Move is checkmate"
          },
          "stalemate": {
            "type": "boolean",
            "description": "Move is stalemate"
          }
        }
      }
    }
  }
}

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.

tablebase