BetterChess

Working · 1.3 s

co.betterchess/betterchessv1.0.0 Domain verified

Chess MCP for Claude: engine analysis, attack maps, game review. One URL, no install.

Entertainment & Games

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.betterchess.co

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

chess_analyse Read-only

Returns 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.

fenstring

FEN of the position.

pgnstring

PGN; the position after the final move is used.

movesarray

SAN moves from the start, e.g. ["e4","e5"].

trapsboolean

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.

multipvnumber

How many candidate moves (1-5, default 3).

consideringstring

A move you are thinking of playing, in SAN, e.g. "Ng5". Returns the evaluation after it and the line that refutes it.

Tools (4)

chess_analyse

read-only

Argument	Type	Description
fen	string	FEN of the position.
pgn	string	PGN; the position after the final move is used.
moves	array	SAN moves from the start, e.g. ["e4","e5"].
traps	boolean	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	number	How many candidate moves (1-5, default 3).
considering	string	A move you are thinking of playing, in SAN, e.g. "Ng5". Returns the evaluation after it and the line that refutes it.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "fen": {
      "type": "string",
      "description": "FEN of the position."
    },
    "pgn": {
      "type": "string",
      "description": "PGN; the position after the final move is used."
    },
    "moves": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "SAN moves from the start, e.g. [\"e4\",\"e5\"]."
    },
    "traps": {
      "type": "boolean",
      "description": "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": {
      "type": "number",
      "description": "How many candidate moves (1-5, default 3)."
    },
    "considering": {
      "type": "string",
      "description": "A move you are thinking of playing, in SAN, e.g. \"Ng5\". Returns the evaluation after it and the line that refutes it."
    }
  }
}

chess_attacks

Returns the exact list of squares attacked by the piece standing on a given square in a chess position, together with that piece's type and colour. Returns an empty list when the square is unoccupied. Accepts a FEN, a PGN, or a list of SAN moves from the starting position.

read-only

Argument	Type	Description
fen	string	FEN of the position.
pgn	string	PGN; the position after the final move is used.
moves	array	SAN moves from the start, e.g. ["e4","e5"].
square*	string	The square, e.g. "d5".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "square"
  ],
  "properties": {
    "fen": {
      "type": "string",
      "description": "FEN of the position."
    },
    "pgn": {
      "type": "string",
      "description": "PGN; the position after the final move is used."
    },
    "moves": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "SAN moves from the start, e.g. [\"e4\",\"e5\"]."
    },
    "square": {
      "type": "string",
      "description": "The square, e.g. \"d5\"."
    }
  }
}

chess_review

Replays a finished game ply by ply with the engine and returns the moves where the evaluation swung by more than a threshold (default 1.5 pawns). Each entry gives the move number, the side that moved, the move played, the engine's preferred move, the size of the swing in pawns, the evaluation before and after, and the FEN of the resulting position. Accepts a PGN or a list of SAN moves, and can be filtered to one colour. Long games are truncated at 60 plies.

read-only

Argument	Type	Description
pgn	string	The finished game as PGN.
moves	array	Or SAN moves from the start.
colour	string	"white" or "black" — whose mistakes to report. Default both.
threshold	number	Swing in pawns that counts as a turning point. Default 1.5.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "pgn": {
      "type": "string",
      "description": "The finished game as PGN."
    },
    "moves": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Or SAN moves from the start."
    },
    "colour": {
      "type": "string",
      "description": "\"white\" or \"black\" — whose mistakes to report. Default both."
    },
    "threshold": {
      "type": "number",
      "description": "Swing in pawns that counts as a turning point. Default 1.5."
    }
  }
}

chess_rig

Returns the JavaScript source of the in-page coaching rig for a chess.com bot game, to be run in that page by the browser's javascript tool. Once running, the page exposes window.__coachWait(ms) (resolves with events and board status), window.__coachWatch.status() (moves, fen, turn, myTurn, result) and window.__coach (beginDraw, play, dashed, label, step, say) for drawing on the board. Also returns the rig version and the URL of the chess.com bot surface.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}