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.
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"]. | |
| 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. |