Analyse a chess position
chess_analyseReturns an engine evaluation of a chess position: the strongest candidate moves with their scores, and the position's checkable facts — side to move, whether that side is in check, undefended pieces and the pieces attacking them, and the material balance. Accepts a FEN, a PGN, or a list of SAN moves from the starting position. Also reports what the OPPONENT would play if it were their turn, which is the difference between a position being quiet and merely looking quiet. Pass considering with a move you are thinking of playing and it returns what that move actually walks into — a losing move is usually not in the top candidates, so asking about it directly is the only way to find out.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "chess_analyse"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fen | No | FEN of the position. | |
| pgn | No | PGN; the position after the final move is used. | |
| moves | No | SAN moves from the start, e.g. ["e4","e5"]. | |
| traps | No | Also scan the captures and checks available to the side to move and return the ones that lose, each with its refutation. Slower — several extra searches. | |
| multipv | No | How many candidate moves (1-5, default 3). | |
| considering | No | A move you are thinking of playing, in SAN, e.g. "Ng5". Returns the evaluation after it and the line that refutes it. |