Skip to main content
Glama
BSalita

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: TexasSolver MCP Server

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"
      ]
    }
  }
}

Maintenance

ActivityMaintained
ResponsivenessNo issues

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
    1
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables interaction with the TexasSolver poker solver to run game theory optimal (GTO) poker calculations, load preflop ranges, and build game trees with structured parameters for analyzing poker hands and strategies.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables playing chess games with legal move validation and AI opponent moves powered by the Stockfish engine. Supports multiple concurrent games and provides moves in UCI format.
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables simulated multi-table No-Limit Texas Hold'em study and decision-support, allowing users to practice against bots and get equity/pot-odds/preflop-chart advice.
    12
    MIT