TokenBurnRate
Track LLM token costs across Claude, GPT and Gemini, with optimization hints and savings estimates.
التثبيت
خطوات التثبيت موجودة في التوثيق أدناه. التوثيق
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
TokenBurnRate
See where your AI tokens go — and how to spend less of them.
TokenBurnRate is an MCP server + CLI that logs every Claude / GPT / Gemini API call locally, shows you a cost dashboard in your terminal, and tells you exactly how to reduce that cost.
⬡ token-tracker LAST 7 DAYS
────────────────────────────────────────────────────────────────────────
Overview
Total cost $18.7421 (~$80.59/month est.)
API calls 347
Input tokens 4.82M
Cache reads 620K (11.4% hit rate)
Daily Cost
Mon Jun 02 ████████████░░░░░░░░░░░░ $2.14
Tue Jun 03 ████████████████████░░░░ $3.82
Thu Jun 05 ████████████████████████ $4.51
💡 Optimization Hints saves $31.20/mo
● CRIT Prompt cache barely used
Cache hit rate: 11.4% — target is 30–60%
Action: Move static content to top of messages
Est. saving: $12.40/month
● HIGH Expensive model doing test generation
104 test-gen calls on Sonnet costing $2.25/week
Action: Route to claude-haiku-4-5, saves 80%
Est. saving: $7.80/monthInstall
npm install -g token-tracker-mcpOr run without installing:
npx token-tracker-mcp reportAdd to Claude Desktop
node scripts/setup.jsOr add manually to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"token-tracker": {
"command": "token-tracker",
"args": ["serve"]
}
}
}Restart Claude Desktop. Done.
CLI Commands
| Command | Description |
|---|---|
token-tracker report | Full 7-day dashboard |
token-tracker report --period month | Monthly report |
token-tracker today | Today only |
token-tracker hints | Optimization hints ranked by $ saving |
token-tracker hint <id> | Deep-dive on one hint |
token-tracker status | One-line: cost · cache % · top hint |
token-tracker budget | Budget gauges |
token-tracker models | Pricing table for all models |
token-tracker export > out.csv | Raw CSV export |
MCP Tools (use inside Claude)
| Tool | Description |
|---|---|
log_usage | Log an API call — auto-calculates cost |
get_summary | Summary for today / week / month / all |
get_hints | Ranked optimization hints with $ savings |
get_hint_detail | Deep-dive on a specific hint |
set_budget | Set a daily / weekly / monthly spend limit |
list_sessions | Sessions ranked by cost |
list_models | Pricing table |
export_csv | CSV dump |
Optimization Hints Engine
8 deterministic rules — no LLM calls, runs instantly on your local data:
| Hint | Triggers when |
|---|---|
cache-utilization | Cache hit rate < 30% |
model-swap-testing | Test gen running on Sonnet / Opus |
model-swap-debug | Debugging on Opus |
verbose-outputs | Output / input ratio > 0.35 |
session-spike | Any session costs 3× your average |
context-bloat | Avg tokens / call > 8K |
retry-loops | Sessions with 30+ high-token calls |
single-model-dependency | 100% traffic on one expensive model |
Each hint includes severity · evidence · recommended action · estimated monthly saving.
Privacy
All data stored at ~/.token-tracker/usage.db (SQLite).
Nothing leaves your machine. No telemetry, no account required.
Development
git clone https://github.com/nikhilnt1234/TokenBurnRate.git
cd TokenBurnRate
npm install --ignore-scripts
npx tsup
npm testRoadmap
- [ ] Team / Supabase backend (multi-user shared dashboard)
- [ ] Weekly email digest
- [ ] Slack / webhook alerts
- [ ] macOS menubar app
License
MIT © 2026 Nikhil T
الأسئلة الشائعة
ما هو TokenBurnRate؟
Track LLM token costs across Claude, GPT and Gemini, with optimization hints and savings estimates.
كيف أثبّت TokenBurnRate؟
اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.
هل TokenBurnRate مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون TokenBurnRate؟
ينشره nikhilnt1234. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.