Skip to main content
Glama

postflop-mcp

An MCP server that solves heads-up postflop spots (flop, turn or river) with a GTO solver and answers questions about the solution. Connect it to Claude or another MCP client and ask "solve this spot" or "how does this hand play here, and why?" — the answers come from solver numbers.

  • Solver: postflop-solver (AGPL-3.0)

  • A single Rust binary using the MCP stdio transport

  • Solved games are cached; solving the same spot again loads in about a second

  • Range charts, game trees and suit-by-suit blocker tables are written as HTML you can open in a browser

  • MCP Registry name: mcp-name: io.github.sawadakaku/postflop-mcp

Install

Claude Desktop

Download postflop-mcp.mcpb from the latest release and open it. It contains binaries for macOS (Apple Silicon and Intel), Linux (x86_64) and Windows (x86_64).

Prebuilt binary

Download the archive for your platform from the latest release, extract it, and put the binary somewhere on your PATH as postflop-mcp. On macOS, if Gatekeeper blocks the downloaded binary, run xattr -d com.apple.quarantine postflop-mcp.

From source

Requires stable Rust (rustup).

cargo install --git https://github.com/sawadakaku/postflop-mcp --locked

This installs ~/.cargo/bin/postflop-mcp.

Related MCP server: MCP Poker

Register with an MCP client

Claude Code:

claude mcp add postflop -- postflop-mcp

Other clients (config file):

{
  "mcpServers": {
    "postflop": { "command": "postflop-mcp" }
  }
}

Usage

Call solve first, then point at nodes with paths.

solve  board="Ks7d2c" oop_range="99-22,AJs-A2s,KTs+,..." ip_range="22+,A2s+,..." pot_bb=5.5 stack_bb=97.5
       names={"oop": "BB", "ip": "BTN"}
node_info    path="x"                        # BTN's frequencies and EVs after BB checks
hand_detail  path="x b33" hand="A7s"         # BB's A7s facing a 33% bet
range_chart  path="x b33 c / 5h" player="BB" # BB's range chart on the 5h turn (HTML)
resolve_from path="x b33 c / 5h / x" tree={"turn": ["50%,a/a", "50%,100%,a/a"]}  # re-solve with other sizes

A path alternates action segments and card segments separated by /: x check, c call, f fold, allin all-in, b75 / r75 a 75%-pot bet / raise.

Tools

Tool

What it does

solve

Solve a spot (or load it from the cache). dry_run only estimates memory

node_info

Player to act, pot, stacks, and frequency / combos / EV per action

hand_detail

A combo's or class's frequencies, EVs and equity per action

range

A range by hand class and by made-hand label

action_range

The hands taking an action, with the value/bluff split

lookahead

Frequencies for the next few actions

range_chart

13x13 range chart (HTML)

tree_view

Clickable game tree with range charts (HTML)

suit_chart

Suit-by-suit table with blocker effects (HTML)

resolve_from

Re-solve from a street start with other sizes, locks, ranges or stack

exploit

Best response to a biased opponent, with gain and risk

bookmark

Name a branch

compare_lines

Compare lines side by side

compare_stacks

Re-solve with other stack depths and compare (HTML too)

Units: amounts and EV are in bb; frequencies, equities and shares are 0-1. EV is the profit from the node on, and folding is 0. Terms are defined in docs/glossary.md; the design is in docs/design.md.

How heavy is it

  • From the river: under a second

  • From the turn: seconds to tens of seconds

  • From the flop: tens of seconds to minutes. With the default tree, a BTN vs BB single-raised pot took about 2.5 minutes, 2GB of memory and a 1GB cache file on an Apple Silicon Mac

For a heavy spot, check the memory first with solve and dry_run=true. Fewer bet sizes (tree) or narrower ranges make it lighter.

The default tree, for both players: flop bets 33% and 75%; turn and river bets 50% and all-in; raises are all-in only.

Environment variables

Name

Default

Meaning

POSTFLOP_MCP_CACHE_DIR

~/.cache/postflop-mcp/games

Where solved games are cached. off disables caching

POSTFLOP_MCP_VIEWS_DIR

~/.cache/postflop-mcp/views

Where HTML views are written

POSTFLOP_MCP_MAX_MEMORY_GB

8

Memory limit for solving. Above it, the game is solved compressed

Cache files can be deleted at any time; the spot is just solved again.

Limitations

  • Heads-up only. Preflop is not solved (you pass the ranges)

  • No rake

  • exploit works only at turn or river nodes

Releasing

Bump version in Cargo.toml and manifest.json, commit, then push a matching tag (git tag v0.2.0 && git push origin v0.2.0). The release workflow tests and builds every platform, creates the GitHub Release with the .mcpb bundle and binaries, and publishes server.json to the MCP Registry.

License

AGPL-3.0-or-later (LICENSE), matching postflop-solver.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      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.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      6 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      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