🃏 poker-with-claude

Play Texas Hold'em against Claude in Claude Code.

Claude actually plays its own hand — looks at its cards, thinks about strategy, bluffs, folds, and raises. No scripted bot.

╔═════════════════════════════════════════════════════╗
║       ♠ ♥ ♦ ♣   POKER vs CLAUDE   ♣ ♦ ♥ ♠         ║
╠═════════════════════════════════════════════════════╣
║                                                     ║
║  CLAUDE'S HAND                                      ║
║  ┌─────┐ ┌─────┐                                   ║
║  │▓▓▓▓▓│ │▓▓▓▓▓│                                   ║
║  │▓▓▓▓▓│ │▓▓▓▓▓│                                   ║
║  │▓▓▓▓▓│ │▓▓▓▓▓│                                   ║
║  └─────┘ └─────┘                                   ║
║─────────────────────────────────────────────────────║
║                      POT: 60                        ║
║       ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐     ║
║       │K    │ │4    │ │10   │ │  ·  │ │  ·  │     ║
║       │  ♥  │ │  ♠  │ │  ♦  │ │     │ │     │     ║
║       │    K│ │    4│ │   10│ │     │ │     │     ║
║       └─────┘ └─────┘ └─────┘ └─────┘ └─────┘     ║
║─────────────────────────────────────────────────────║
║                                                     ║
║  YOUR HAND                                          ║
║  ┌─────┐ ┌─────┐                                   ║
║  │A    │ │9    │                                   ║
║  │  ♠  │ │  ♦  │                                   ║
║  │    A│ │    9│                                   ║
║  └─────┘ └─────┘                                   ║
╠═════════════════════════════════════════════════════╣
║        You: 990 chips  |  Claude: 980 chips         ║
╠═════════════════════════════════════════════════════╣
║     call  •  raise <amount>  •  fold  •  all-in     ║
╚═════════════════════════════════════════════════════╝

Install

One command:

claude mcp add poker -- npx -y poker-with-claude

That's it. Open Claude Code and say "deal me in".

How to play

Just talk to Claude:

• "Deal me in" — starts a new hand
• "Call" — match the bet
• "Raise 100" — raise the stakes
• "All in" — send it
• "Fold" — live to fight another hand
• "Show my poker stats" — see your career record

How it works

This is an MCP server with 4 tools:

• poker_deal — deals a new hand, gives Claude its private hole cards
• poker_action — processes the player's action
• poker_claude_action — Claude decides and plays its own hand
• poker_stats — lifetime win/loss record

Claude sees its own cards but not yours (until showdown). It makes real poker decisions — calling, raising, bluffing, folding — based on hand strength, pot odds, and board texture.

Cards are shuffled with crypto.randomInt() for true randomness. No rigging.

Features

• Full Texas Hold'em — preflop, flop, turn, river, showdown
• Claude plays for real — the LLM reads its cards and decides its moves
• Fair game — Claude can't see your cards, cryptographic shuffle
• ASCII poker table — always-visible card UI with phase tracker
• Trash talk — Claude has personality
• Persistent stats — tracks wins, losses, streaks across sessions

Uninstall

claude mcp remove poker

License

MIT — gamble responsibly.