MCP Stockfish MCP Server

A Model Context Protocol server that lets your AI talk to Stockfish. Because apparently we needed to make chess engines even more accessible to our

Local serverstdioGo

What is the MCP Stockfish MCP server?

If you already use MCP Stockfish, the mcp stockfish mcp server is the piece that lets your assistant work with it directly. A Model Context Protocol server that lets your AI talk to Stockfish. Because apparently we needed to make chess engines even more accessible to our silicon overlords.

What the server does

This creates a bridge between AI systems and the Stockfish chess engine via the MCP protocol. It handles multiple concurrent sessions because your AI probably wants to analyze seventeen positions simultaneously while you're still figuring out why your knight is hanging.

  • 🔄 Concurrent Sessions — Run multiple Stockfish instances without your CPU crying
  • ⚡ Full UCI Support — All the commands you need, none of the ones you don't
  • 🎯 Actually Works — Unlike your last side project, this one has proper error handling
  • 📊 JSON Everything — Because apparently we can't just use plain text anymore
  • 🐳 Docker Ready — Containerized for when you inevitably break your local setup

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • uci — Initializes the engine in UCI mode
  • isready — Checks if the engine is ready. Returns readyok
  • stop — Stops current search
  • quit — Closes the session
  • Installation — The Installation tool exposed by this server
  • Usage — The Usage tool exposed by this server
  • Logging — The Logging tool exposed by this server

Credentials and setup notes

Configuration is passed through the environment: MCP_STOCKFISH_LOG_LEVEL, MCP_STOCKFISH_PATH, MCP_STOCKFISH_HTTP_HOST. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Plenty of cloud and infrastructure servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. MCP Stockfish's toolset — uci, isready, stop and 4 more — is a fair guide to whether it matches your workflow. It is maintained by sonirico; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
uciInitializes the engine in UCI mode
isreadyChecks if the engine is ready. Returns readyok
stopStops current search
quitCloses the session
InstallationThe Installation tool exposed by this server.
UsageThe Usage tool exposed by this server.
LoggingThe Logging tool exposed by this server.

How to install the MCP Stockfish MCP server

{
  "mcpServers": {
    "chess": {
      "command": "mcp-stockfish",
      "env": {
        "MCP_STOCKFISH_LOG_LEVEL": "info"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
MCP_STOCKFISH_LOG_LEVELConfiguration value read at startup.Optional
MCP_STOCKFISH_PATHFilesystem location the server is allowed to use.Optional
MCP_STOCKFISH_HTTP_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • Use MCP Stockfish to uci.
  • Use MCP Stockfish to isready.
  • Use MCP Stockfish to stop.

Frequently asked questions

It connects MCP Stockfish to MCP-compatible AI assistants such as Claude and Cursor, exposing 7 tools (uci, isready, stop, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP Stockfish directly.