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: gap

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

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
  • A
    license
    A
    quality
    C
    maintenance
    Enables any local AI agent to play turn-based games over MCP by exposing reset, observe, and act verbs with structured observations and validated legal actions.
    6
    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
    B
    quality
    B
    maintenance
    Enables chess agents to query Stockfish evaluations (MultiPV, win/draw/loss probabilities, positional motifs) alongside a Neo4j positional graph of games and opening/endgame theory plus PostgreSQL telemetry. This lets the agent determine which moves are playable in a given position and deliver data-backed semantic coaching.
    6
    2
    MIT