@pokerai/mcp
An MCP server that gives LLM agents solver-grade GTO strategy lookups for 6-max 100bb NLHE through the Pokerai API.
preflop_versions— list selectable chart-set ids/labels and the default (free).preflop_strategy— fold/call/raise frequencies + sizes for one hand facing a preflop action line (1 presolved quota).preflop_range— the full 169-hand-type range for a position + action line in a single call (1 presolved quota).flop_tree— starting ranges and every decision node (withnodetokens) for a flop spot: SRP / 3BET / 4BET / LIMP (1 presolved quota).flop_node— strategy at one flop node, either for a specific hole hand or whole range (free, token-gated).With
POKERAI_ENABLE_SOLVE=1, also real-time solver tools for flop/turn/river:solve_schedule,solve_tree,solve_node,node_evs(spends solve quota).Uses your own
POKERAI_API_KEY; free tier is 10 presolved lookups + 5 solves/month.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@pokerai/mcp what's GTO for AKs on the button facing a UTG open?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@pokerai/mcp
MCP server for the Pokerai API — solver-grade GTO strategy for 6-max No-Limit Hold'em, exposed as tools your LLM agent (Claude, Cursor, Claude Code, …) can call.
Ask "what's GTO for AKs on the button facing a UTG open?" and the agent gets real presolved frequencies, not a guess.
Setup
You need a Pokerai API key — get one free at https://pokerai.bet/login.
The server runs over stdio via npx, so there's nothing to install globally.
Claude Desktop
Add to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"pokerai": {
"command": "npx",
"args": ["-y", "@pokerai/mcp"],
"env": { "POKERAI_API_KEY": "gto_your_key_here" }
}
}
}Claude Code
claude mcp add pokerai -e POKERAI_API_KEY=gto_your_key_here -- npx -y @pokerai/mcpCursor
~/.cursor/mcp.json (or Settings → MCP), same shape as the Claude Desktop block above.
Related MCP server: MCP Poker
Tools
Presolved lookups (spend your presolved quota — 10/mo on the free tier):
Tool | What it returns |
| selectable strategy chart sets (free) |
| fold/call/raise frequencies for a hand vs an action line |
| the whole 169-hand-type range for a position + line |
| flop decision tree (nodes carry tokens); optional |
| strategy at one flop node (with or without a hero hand) |
Real-time solver (flop/turn/river) — off by default because it spends the scarce solve quota
(5/mo on the free tier). Enable with POKERAI_ENABLE_SOLVE=1:
Tool | What it returns |
| trigger an on-demand solve (costs 1 solve quota) |
| poll the solve + get its nodes |
| strategy at one solved node |
| per-hand, per-action EVs at a node |
Environment
Var | Purpose |
| required — your key from https://pokerai.bet/login |
| set to |
| override the API base (default |
Notes
The server authenticates with your key and spends your quota — it holds no shared credential and has no abuse surface of its own.
stdout is the MCP protocol channel; the server logs only to stderr.
About Pokerai API
Pokerai API provides solver-grade GTO strategy and poker computation APIs for training products, review tools, coaches, researchers, and AI agents.
Free tier: 10 presolved lookups + 5 real-time solves per month.
Real-time assistance (RTA) at real-money tables is prohibited.
Website: https://pokerai.bet/
Docs: https://pokerai.bet/docs
API reference: https://pokerai.bet/reference
OpenAPI: https://pokerai.bet/openapi.en.json
MIT licensed. Docs: https://pokerai.bet/docs · Reference: https://pokerai.bet/reference
Available Tools
5 toolsflop_nodeFlop node strategyA
Strategy at one flop decision-tree node. Pass a node token minted by flop_tree. With hole_cards → that hand's mixed strategy at the node; omit → the node's whole-range strategy. Free (token-gated).
Inputs: node (required), hole_cards.
flop_treeFlop decision treeA
Starting ranges + every decision node for a flop spot. Each node carries a node token to pass to flop_node. Charges 1 presolved quota. Single-street (for turn/river use the solver tools).
Inputs: board (required), pot_type (required), positions (required).
preflop_rangeWhole preflop range for a spotA
The full 169-hand-type range (fold/call/raise per hand type: AA, AKs, AKo, ...) for a position + action line. No hole_cards. Charges 1 presolved quota (one call, not 169).
Inputs: hero (required), preflop_actions (required), table_size, preflop_version.
preflop_strategyPreflop GTO strategy for a handB
GTO mixed strategy (fold/call/raise frequencies + sizes) for a specific hand facing a preflop action line, 6-max 100bb. Charges 1 presolved quota. The situation (RFI/3-bet/4-bet/...) is derived from the actions.
Inputs: hero (required), hole_cards (required), preflop_actions (required), preflop_version.
preflop_versionsList preflop strategy versionsA
The selectable preflop_version values (id + human label) and which is the default. Free (no quota). Call this before assuming a version id.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct aspect: preflop_versions for metadata, preflop_strategy for a single hand's preflop strategy, preflop_range for full range, flop_tree for generating flop decision nodes, and flop_node for querying a specific node. Their descriptions clearly differentiate them.
All tool names follow a consistent snake_case pattern with a street prefix (preflop_ or flop_) and a descriptive suffix (versions, strategy, node, range, tree). The naming is predictable and uniform.
5 tools is well-scoped for a poker GTO solver covering preflop and flop analysis. Each tool serves a specific purpose without redundancy or unnecessary complexity.
The set covers preflop and flop strategies comprehensively, but notably lacks turn/river analysis, as acknowledged in flop_tree's description. This leaves a significant gap for full hand analysis, but within its intended scope it is reasonably complete.
Maintenance
Related MCP Connectors
Live Texas Hold'em for AI agents. The tools teach the rules; the bluffing is up to your model.
MCP server exposing the Backtest360 engine API as tools for AI agents.
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for toolhouse.ai. This does not rely on an external llm unlike the official server.4MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides poker play recommendations by combining real-time Monte Carlo equity calculations with historical player tracking and exploit-based advice. It enables users to import PokerNow hand histories to analyze player tendencies and receive data-driven coaching for various game situations.1-
- AlicenseNot gradedqualityDmaintenanceMCP server that exposes Moleculer.js microservice actions as AI tools, enabling AI agents to interact with Moleculer services.5 npm4MIT
- FlicenseNot gradedqualityDmaintenanceLocal MCP server that exposes fixed tools for GPT, Claude, and Gemini while routing to any OpenAI-compatible chat completions backend with independent configuration per target.1-