chess-mcp
by kamol1dn
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Listen host. Docker sets HOST to 0.0.0.0. | 127.0.0.1 |
| PORT | No | Listen port. Docker sets HOST to 0.0.0.0. | 8787 |
| CHESS_DB | No | SQLite database file path (`:memory:` for ephemeral). | <dir>/chess.db |
| LOG_LEVEL | No | pino log level. | info |
| CHESS_API_KEY | No | Requires a bearer key to create games, claim seats, delete games and use /mcp. | |
| CHESS_WEB_DIR | No | Serve the web UI from another directory. | built-in |
| CHESS_DATA_DIR | No | SQLite data directory (`:memory:` for ephemeral). | ./data |
| CHESS_MCP_HOME | No | Home directory variable read by CLI clients. | |
| CHESS_PUBLIC_URL | No | Base URL used in links and agent instructions. | http://localhost:PORT |
| CHESS_RATE_LIMIT | No | Write requests per minute per IP. | 300 |
| CHESS_SEAT_TOKEN | No | Seat token for CLI clients; can also be passed with --side. | |
| CHESS_SERVER_URL | No | The stdio MCP server connects to this URL; if nothing is running there, it starts an embedded chess server itself. | http://localhost:8787 |
| ANTHROPIC_API_KEY | No | Enables Claude API players. | |
| CHESS_ANALYSIS_MS | No | Engine time per position for the eval bar; `0` disables it. | 300 |
| CHESS_TRUST_PROXY | No | Trust `X-Forwarded-*` headers. | false |
| CHESS_MOVE_DELAY_MS | No | Pause before engine and Claude moves, so spectators can follow. | 400 |
| ANTHROPIC_AUTH_TOKEN | No | Alternative to ANTHROPIC_API_KEY for Claude API player credentials. | |
| CHESS_ENGINE_THREADS | No | Engine worker threads. | CPUs - 1 (max 4) |
| CHESS_LLM_MAX_ATTEMPTS | No | Illegal answers a Claude player may give before it forfeits. | 3 |
| CHESS_MAX_ACTIVE_GAMES | No | Capacity limit. | 200 |
| CHESS_IDLE_TIMEOUT_HOURS | No | Abort games with no activity; `0` disables. | 24 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues