postflop-mcp
by sawadakaku
README.md
# 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](https://github.com/b-inary/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](https://github.com/sawadakaku/postflop-mcp/releases/latest) 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](https://github.com/sawadakaku/postflop-mcp/releases/latest), 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](https://rustup.rs/)).
```bash
cargo install --git https://github.com/sawadakaku/postflop-mcp --locked
```
This installs `~/.cargo/bin/postflop-mcp`.
## Register with an MCP client
Claude Code:
```bash
claude mcp add postflop -- postflop-mcp
```
Other clients (config file):
```json
{
"mcpServers": {
"postflop": { "command": "postflop-mcp" }
}
}
```
## Usage
Call `solve` first, then point at nodes with paths.
```text
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](docs/glossary.md); the design is in [docs/design.md](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](LICENSE)), matching postflop-solver.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues