Pokerai API

io.github.pokerai-betPublished by GitHub account pokerai-betv0.1.4Updated Nov 6, 2026

Solver-grade GTO strategy for study. Real-time assistance (RTA) at real-money tables is prohibited.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Pokerai API MCP server that gives an assistant solver-grade GTO preflop and flop strategy lookups for 6-max No-Limit Hold'em study.

What you can do
  • List selectable preflop strategy chart sets and their default version
  • Get GTO fold/call/raise frequencies and sizes for a hand facing a preflop action line
  • Retrieve the full 169-hand-type range for a position and action line
  • Fetch a flop decision tree with node tokens, then read strategy at a single node with or without a specific hand
  • Optionally, when enabled, schedule real-time solves and read solved nodes and per-hand EVs
When to use it
Useful for poker study, coaching, review tools and research where you want real presolved GTO frequencies instead of an assistant's guess about preflop or flop spots in 6-max 100bb No-Limit Hold'em.
Requirements
Runs locally over stdio via npx (Node.js), configured in the client's MCP config. Requires a Pokerai API key in the POKERAI_API_KEY environment variable, obtained from the provider's login page. Network access to the Pokerai API. The real-time solver tools appear only when POKERAI_ENABLE_SOLVE is set to 1.
Before you install
The server spends your own quota: presolved lookups cost 1 presolved quota each (10 per month on the free tier) and real-time solves cost the scarcer solve quota (5 per month free). POKERAI_API_KEY is a secret sent to the provider's API. Real-time assistance at real-money tables is prohibited by the provider, so use it for study only.

Installation

In SourceWeft

  1. Open Pokerai API in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@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):

json
{  "mcpServers": {    "pokerai": {      "command": "npx",      "args": ["-y", "@pokerai/mcp"],      "env": { "POKERAI_API_KEY": "gto_your_key_here" }    }  }}

Claude Code

bash
claude mcp add pokerai -e POKERAI_API_KEY=gto_your_key_here -- npx -y @pokerai/mcp

Cursor

~/.cursor/mcp.json (or Settings → MCP), same shape as the Claude Desktop block above.

Tools

Presolved lookups (spend your presolved quota — 10/mo on the free tier):

ToolWhat it returns
preflop_versionsselectable strategy chart sets (free)
preflop_strategyfold/call/raise frequencies for a hand vs an action line
preflop_rangethe whole 169-hand-type range for a position + line
flop_treeflop decision tree (nodes carry tokens); optional flop_version picks the dataset
flop_nodestrategy 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:

ToolWhat it returns
solve_scheduletrigger an on-demand solve (costs 1 solve quota)
solve_treepoll the solve + get its nodes
solve_nodestrategy at one solved node
node_evsper-hand, per-action EVs at a node

Environment

VarPurpose
POKERAI_API_KEYrequired — your key from https://pokerai.bet/login
POKERAI_ENABLE_SOLVEset to 1 to expose the real-time solver tools
POKERAI_API_BASEoverride the API base (default https://pokerai.bet)

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.

MIT licensed. Docs: https://pokerai.bet/docs · Reference: https://pokerai.bet/reference

Source: README.md at commit 07a86c5

Tools

5

preflop_versions

List preflop strategy versions

The selectable preflop_version values (id + human label) and which is the default. Free (no quota). Call this before assuming a version id.

Takes no parameters.

preflop_strategy

Preflop GTO strategy for a hand

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.

Parametersherorequiredhole_cardsrequiredpreflop_actionsrequiredpreflop_version

preflop_range

Whole preflop range for a spot

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).

Parametersherorequiredtable_sizepreflop_actionsrequiredpreflop_version

flop_tree

Flop decision tree

Starting ranges + every decision node for a flop spot. In the response each node has `node`, its path (e.g. root/CHECK), and `token`; pass `token` as the `node` argument of flop_node. Charges 1 presolved quota. Single-street (for turn/river use the solver tools).

Parametersboardrequiredpot_typerequiredpositionsrequiredflop_version

flop_node

Flop node strategy

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).

Parametersnoderequiredhole_cards

Version history

3
  1. v0.1.4LatestNov 5, 2026
  2. v0.1.3Nov 1, 2026
  3. v0.1.2Oct 31, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts