Poker Bankroll Tracker
MCP server for the Poker Bankroll Tracker API
Ask AI about Poker Bankroll Tracker
Powered by Claude · Grounded in docs
I know everything about Poker Bankroll Tracker. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Poker Bankroll Tracker MCP Server
An MCP (Model Context Protocol) server that wraps the Poker Bankroll Tracker API, letting AI assistants query poker session data.
Install
npm install -g poker-bankroll-tracker-mcp
Or run directly with npx:
PBT_API_KEY="your-api-key" npx poker-bankroll-tracker-mcp
Configuration
Environment Variable
The server requires a PBT_API_KEY environment variable with your Poker Bankroll Tracker API key.
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 Tools
get_sessions
Fetch poker sessions with optional filters. Returns session data with calculated profit/loss.
Note: Broad date ranges may return many sessions and consume significant tokens. Use narrow date ranges when possible.
Parameters:
| Name | Type | Description |
|---|---|---|
start | string | Start date (YYYY-MM-DD) |
end | string | End date (YYYY-MM-DD) |
type | string | Session type: cashgame, tournament, payout, costs, casinogame, jackpot (comma-separated) |
currency | string | ISO currency codes (comma-separated) |
staking | boolean | Filter by staking sessions |
All parameters are optional.
Example:
Get my cash game sessions from March 2026
-> 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:
How am I doing at 1/2 NLH this year?
-> get_stats({ start: "2026-01-01", type: "cashgame" })
API Notes
- Rate limit: The Poker Bankroll Tracker API allows 20 requests per 15 minutes. The server caches responses for 10 seconds to reduce API usage.
- Base URL:
https://api.pokerbankrolltracker.net/v1 - Auth: Bearer token via
PBT_API_KEY
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
