Skip to main content
Glama
endplay-dd-mcp-server

endplay-dd-mcp-server

by BSalita

endplay-dd-mcp-server

MCP server exposing endplay double-dummy calculations through a first-party REST API. The MCP process is an HTTP client and never imports Endplay directly.

Tools

  • double_dummy(pbn: str)
    Returns a full 20-cell trick table (N/E/S/W declarer x C/D/H/S/NT strain).

  • double_dummy_batch(pbns: list[str])
    Same result shape for multiple deals in one call.

Related MCP server: gambit

Setup

cd c:/sw/bridge/ML-Contract-Bridge/src/endplay-dd-mcp-server
python -m venv .venv
.venv/Scripts/activate
pip install -e .

Run

Start the first-party API, then the MCP client:

endplay-dd-api
# In another terminal:
endplay-dd-mcp

The MCP server runs over stdio by default. Configure its API endpoint with ENDPLAY_DD_API_BASE_URL (default http://127.0.0.1:8001).

Example input

N:9642.95.AKQT4.K7 KJ3.K3.98.T98654 AQT85.Q862..AQJ2 7.AJT74.J76532.3

Example output (shape)

{
  "ok": true,
  "pbn": "<input>",
  "table": {
    "denom_order": ["C", "D", "H", "S", "N"],
    "player_order": ["N", "E", "S", "W"],
    "by_declarer": {
      "N": {"C": 8, "D": 8, "H": 7, "S": 7, "N": 9},
      "E": {"C": 5, "D": 5, "H": 6, "S": 0, "N": 4},
      "S": {"C": 8, "D": 7, "H": 7, "S": 7, "N": 9},
      "W": {"C": 5, "D": 6, "H": 5, "S": 0, "N": 4}
    }
  }
}

Cursor MCP config example

Ensure endplay-dd-api is running, then add this server in your MCP config:

{
  "mcpServers": {
    "endplay-dd": {
      "command": "c:/sw/bridge/ML-Contract-Bridge/src/endplay-dd-mcp-server/.venv/Scripts/python.exe",
      "args": [
        "-m",
        "endplay_dd_mcp.server"
      ]
    }
  }
}

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to analyze shogi (Japanese chess) positions and moves by integrating with USI protocol engines. Provides position analysis, move evaluation, and game state assessment through HTTP API bridge and MCP tools.
      3
      2
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables an AI host to perform bounded Stockfish engine analysis, whole-game review, opening-knowledge lookup, tactical puzzles, and persistent position-specific tutoring sessions. It also supports graduated hints, spaced review, speech plans, and optional local synthesis or board-screenshot recognition over stdio or HTTP transports.
      58
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to join 250game-server rooms as ordinary players over native WebSocket without modifying the game server, supporting room setup, card play and manipulation, scoring, and turn-based decisions while filtering hidden information and rejecting stale-state actions.
      16
      MIT