MCP Poker
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Poker
An MCP server for poker play recommendations — real equity calculations, player tracking, and exploit-based recommendations.
How It Works
Equity engine: Monte Carlo simulation using
phevaluator(a fast C-based poker hand evaluator). Suits, flushes, and all hand types are fully accounted for. No hardcoded hand rankings — everything is computed.Player tracking: Imports PokerNow hand histories, stores all hands/actions in SQLite, and computes detailed player statistics (VPIP, PFR, 3-bet, c-bet, aggression, WTSD, etc.)
Exploit engine: Detects player leaks from historical data and adjusts GTO recommendations to exploit specific tendencies.
Multi-way aware: Advice adjusts based on number of players in the hand — bluffing less in multi-way, tightening value ranges, accounting for equity dilution.
Related MCP server: League of Legends MCP Server
Architecture
src/ # TypeScript source (MCP server)
├── index.ts # Entry point — wires tools to MCP server
├── tools/
│ ├── import.ts # import_pokernow_log, set_hero, set_player_alias, add_player_note
│ ├── player.ts # get_player_stats, get_player_tendencies, get_player_profile, list_players
│ ├── recommend.ts # recommend_action (main coaching tool)
│ ├── history.ts # search_hands, analyze_hand, get_session_summary, list_sessions
│ └── guide.ts # get_tool_guide (LLM documentation)
├── gto/
│ ├── preflop-ranges.ts # Equity-driven preflop advice (no hardcoded ranges)
│ ├── postflop.ts # MC equity calculator bridge + postflop advice engine
│ └── exploit.ts # Player leak detection + exploit adjustments
├── db/
│ ├── schema.ts # SQLite schema + auto-migration
│ └── queries.ts # All DB queries + stat calculations + player profiles
└── types.ts # Shared TypeScript types
python/ # Python (equity calculations, CSV parsing)
├── equity_calculator.py # Monte Carlo equity calculator using phevaluator
├── parse_pokernow.py # PokerNow CSV log parser
└── requirements.txt
data/ # SQLite database (created at runtime, gitignored)src/= TypeScript source codedist/= Compiled JavaScript output (gitignored, built bynpm run build)python/= Python scripts called by the TS server.venv/= Python virtual environment with phevaluator
Setup
Prerequisites
Node.js >= 18
Python 3.8+
Install
npm install
npm run build
python3 -m venv .venv
.venv/bin/pip install phevaluatorAdd to Cursor
The .cursor/mcp.json is already configured. After opening this project in Cursor, the server should be available. If not, add to your MCP config:
{
"mcpServers": {
"poker": {
"command": "node",
"args": ["/path/to/mcp-poker/dist/index.js"]
}
}
}Tools (14 total)
Tool | Description |
| Import a PokerNow CSV hand history file |
| Set which player is you |
| Link two PokerNow IDs as the same person |
| Save a note about a player |
| Full stat sheet (VPIP, PFR, 3-bet, c-bet, AF, WTSD, etc.) |
| Natural language leak analysis + exploit recommendations |
| Comprehensive behavioral dossier (positional, multi-way, trends, showdowns) |
| List all tracked players |
| Real-time coaching with Monte Carlo equity + exploit adjustments |
| Query hand history with filters |
| Deep replay of a specific hand |
| Session results + biggest pots |
| List all imported sessions |
| Returns full documentation on all tools for the LLM |
For detailed input/output specs for every tool, call get_tool_guide from the LLM or see src/tools/guide.ts.
Data Storage
All data is stored locally in data/poker.db (SQLite). Nothing leaves your machine.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Train on solver poker strategy and look up the solver's play for a hand you describe.
Claude and ChatGPT use the ART/GTO poker solver on your PC: solved spots, hand reviews, solves.
Exact Texas Hold'em equity and hand analysis, every runout enumerated. Free, no API key.
MCP server for VC pitch-deck scoring, thesis-fit matching, and deal-flow management.
Related MCP Servers
- AlicenseCqualityDmaintenanceA Model Context Protocol server that allows AI agents to play Texas Holdem poker games through an MCP client interface.197ISC
- AlicenseBqualityBmaintenanceMCP server exposing 30 tools for League of Legends player analysis, match review, and training-plan generation.358 npm1MIT
- AlicenseAqualityCmaintenanceMCP server for the Pokerai API providing solver-grade GTO strategy for 6-max No-Limit Hold'em, exposed as tools for LLM agents like Claude and Cursor.5194 npmMIT
- AlicenseAqualityDmaintenanceEnables 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.12MIT