Poker Bankroll Tracker MCP + CLI

Low-context command-line interface and MCP (Model Context Protocol) server for the Poker Bankroll Tracker API.

The CLI is the preferred agent surface: it exposes the same sessions and stats capabilities without loading MCP tool schemas into context. The MCP server remains available for MCP clients.

Install

npm install -g poker-bankroll-tracker-mcp

Or run directly with npx:

PBT_API_KEY="your-api-key" npx poker-bankroll-tracker-mcp

After global install, both binaries are available:

poker-bankroll-tracker --help
poker-bankroll-tracker-mcp

Related MCP server: Questrade MCP Server

Configuration

Environment Variable

Both the CLI and MCP server require PBT_API_KEY with your Poker Bankroll Tracker API key. The API uses Bearer auth and is rate-limited to 20 requests per 15 minutes.

export PBT_API_KEY="your-api-key"

CLI

Command name: poker-bankroll-tracker

The CLI rejects unknown flags/arguments and validates every filter. Errors go to stderr with non-zero exit codes. --json emits strict JSON to stdout and no extra output.

sessions

Fetch poker sessions with calculated profit/loss.

poker-bankroll-tracker sessions [--start YYYY-MM-DD] [--end YYYY-MM-DD] [--currency USD,EUR] [--type cashgame,tournament,...] [--staking] [--json]

Flags:

Examples:

poker-bankroll-tracker sessions --start 2026-03-01 --end 2026-03-31
poker-bankroll-tracker sessions --type cashgame,tournament --currency USD,EUR
poker-bankroll-tracker sessions --staking --json

stats

Compute aggregate statistics: total profit, win rate, average session profit, total sessions, breakdowns by location/stakes/month.

poker-bankroll-tracker stats [--start YYYY-MM-DD] [--end YYYY-MM-DD] [--currency USD,EUR] [--type cashgame,tournament,...] [--staking] [--json]

Flags are identical to sessions.

Examples:

poker-bankroll-tracker stats --start 2026-01-01
poker-bankroll-tracker stats --type cashgame --currency USD
poker-bankroll-tracker stats --staking --json

CLI JSON Output

sessions --json returns the same formatted session objects as the MCP get_sessions tool, including computed profit and cash-game stakes when available.

stats --json returns the same aggregate object as the MCP get_stats tool:

• totalSessions

• totalProfit

• winRate

• avgSessionProfit

• currencies

• byLocation

• byStakes

• byMonth

MCP Configuration

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "poker-bankroll-tracker": {
      "command": "npx",
      "args": ["-y", "poker-bankroll-tracker-mcp"],
      "env": {
        "PBT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "poker-bankroll-tracker": {
      "command": "npx",
      "args": ["-y", "poker-bankroll-tracker-mcp"],
      "env": {
        "PBT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Other MCP Clients

Run the server over stdio:

PBT_API_KEY="your-api-key" poker-bankroll-tracker-mcp

Available MCP Tools

get_sessions

Fetch poker sessions with optional filters. Returns session data with calculated profit/loss.

Broad date ranges may return many sessions and consume significant tokens. Use narrow date ranges when possible.

Parameters:

All parameters are optional.

Example:

get_sessions({ start: "2026-03-01", end: "2026-03-31", type: "cashgame" })

get_stats

Compute aggregate statistics: total profit, win rate, average session profit, total sessions, breakdowns by location/stakes/month.

Takes the same filter parameters as get_sessions.

Example:

get_stats({ start: "2026-01-01", type: "cashgame" })

API Notes

• Rate limit: 20 requests per 15 minutes.

• Base URL: https://api.pokerbankrolltracker.net/v1

• Auth: Bearer token via PBT_API_KEY

• Client cache: responses cached for 10 seconds to reduce API usage.

Development

git clone https://github.com/0xAndoroid/poker-bankroll-tracker-mcp.git
cd poker-bankroll-tracker-mcp
npm install
npm run build

npm run dev        # Watch mode
npm test           # Run tests
npm run lint       # Lint with oxlint
npm run format     # Format with oxfmt

License

MIT