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)

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

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