MCP Chess

get_turn

Indicates whose turn it is ('white' or 'black').

new_game

Starts a new game, resetting the board to the initial position. Args: user_plays_white: Whether the user will play as white. Defaults to True. Returns: A confirmation message indicating the game has started and the user's color.

make_move

Makes a move on the board using standard algebraic notation (SAN). Args: move_san: The player's move in algebraic notation (e.g., 'e4', 'Nf3', 'Bxe5'). Returns: A dictionary containing the move in SAN format, the move in UCI format, the new board FEN, whether the game is over, and the result if applicable.

get_valid_moves

Lists all legal moves for the current player in UCI notation.

find_position_in_pgn

Finds the first board position in a PGN string that matches a given condition (e.g., 'bishop on a3') and returns an image of that board. Args: pgn_string: The PGN string of the game. condition: A string describing the condition, format: "piece_type on square_name" (e.g., "bishop on a3", "knight on f6", "king on g1"). Returns: An Image dictionary containing the PNG data of the board state if found, or a string with an error message.

get_board_visualization

Provides the current state of the chessboard as an image.