home / mcp / mcp poker server

MCP Poker Server

Provides poker coaching with Monte Carlo equity calculations, player tracking, and exploit-based recommendations.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "alanyangrice-mcp-poker": {
      "command": "node",
      "args": [
        "/path/to/mcp-poker/dist/index.js"
      ]
    }
  }
}

You are configuring an MCP server specialized for poker play recommendations. This server computes real equity, tracks players, and provides exploit-based coaching to adapt to multi-way dynamics and observed tendencies. It integrates a Monte Carlo equity engine, a player-tracking database, and an exploit-driven guidance system to help you make informed coaching decisions during play.

How to use

Start and connect to the MCP Poker server from your MCP client. The server analyzes hands from PokerNow histories, computes equity-based guidance, and adjusts recommendations based on observed player tendencies. When you run a coaching session, you receive real-time advice that accounts for the number of players in the hand and exploitable leaks.

How to install

Prerequisites and setup are straightforward. Ensure you have the required runtimes installed, build the server, and install the Python dependency for equity calculations.

npm install
npm run build
python3 -m venv .venv
.venv/bin/pip install phevaluator

Configuration and usage notes

The server is designed to be started by your MCP client, but you can also integrate it using a local command configuration. A ready-to-use configuration example is provided for a local MCP setup.

{
  "mcpServers": {
    "poker": {
      "command": "node",
      "args": ["/path/to/mcp-poker/dist/index.js"]
    }
  }
}

Available tools

import_pokernow_log

Import a PokerNow CSV hand history file into the local SQLite store.

set_hero

Designate which player represents you in analyses and coaching sessions.

set_player_alias

Link two PokerNow IDs to the same player profile for unified tracking.

add_player_note

Attach a note to a tracked player for quick reference.

get_player_stats

Retrieve a full stat sheet with metrics like VPIP, PFR, 3-bet, c-bet, aggression, WTSD, and more.

get_player_tendencies

Run natural language leakage analysis and receive exploit-oriented recommendations.

get_player_profile

Obtain a behavioral dossier covering positions, multi-way tendencies, and showdowns.

list_players

List all players currently tracked in the local database.

recommend_action

Get real-time coaching with MC equity estimates and exploit adjustments.

search_hands

Query hand histories using various filters to locate specific situations.

analyze_hand

Deep-dive replay and analysis of a single hand.

get_session_summary

View session results and identify the biggest pots and pivotal hands.

list_sessions

List all imported sessions for review or export.

get_tool_guide

Provide full tool documentation for the LLM to reference when guiding users.