Does usage data leave the machine?

No. Data is stored locally at ~/.token-tracker/usage.db in SQLite, with no telemetry or account required.

How are optimization hints generated?

Eight deterministic rules analyze local usage data without making LLM calls. Each hint includes severity, evidence, a recommended action, and estimated monthly savings.

Can I use TokenBurnRate through MCP?

Yes. Its MCP tools include usage logging, summaries, hints, budgets, session and model listings, and CSV export.

TokenBurnRate

cost-trackingllmanalyticsdeveloper-tools

Local MCP server and CLI for tracking Claude, GPT, and Gemini token costs and identifying optimization savings.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "nikhilnt1234-tokenburnrate": {
      "command": "npx",
      "args": [
        "-y",
        "token-tracker-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

TokenBurnRate records LLM API usage locally in SQLite, calculates costs, and provides summaries, budgets, session rankings, and CSV exports. Its deterministic hint engine identifies patterns such as low cache usage, expensive model choices, context bloat, and retry loops. Use it when you need local cost visibility and optimization guidance without sending usage data to a remote service.

Use cases

Track API call costs across Claude, GPT, and Gemini

Review daily, weekly, or monthly token spending

Identify model, caching, context, and retry inefficiencies

Set spending limits for daily, weekly, or monthly budgets

Export usage records as CSV

Key features

Local SQLite usage storage

Automatic cost calculation

Ranked optimization hints with estimated monthly savings

Budget limits and spending summaries

Session and model cost rankings

CSV export

Capabilities & Tool Schemas (8)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by TokenBurnRate.

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

Documentation Overview

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.

Code

  ⬡ 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/month

Install

Terminal

npm install -g token-tracker-mcp

Or run without installing:

Terminal

npx token-tracker-mcp report

Add to Claude Desktop

bash

node scripts/setup.js

Or add manually to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

bash

git clone https://github.com/nikhilnt1234/TokenBurnRate.git
cd TokenBurnRate
npm install --ignore-scripts
npx tsup
npm test

Roadmap

Team / Supabase backend (multi-user shared dashboard)
Weekly email digest
Slack / webhook alerts
macOS menubar app

License

Read the full README →View source on GitHub →

Related MCP Servers

View all in Cloud Platforms View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

Package downloads in the last 30 days.

Last commit

3mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about TokenBurnRate

It tracks API calls, token usage, cache reads, models, sessions, and calculated costs for Claude, GPT, and Gemini usage.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/nikhilnt1234-tokenburnrate?style=directory)](https://allmcps.com/mcp/nikhilnt1234-tokenburnrate)

HTML Embed

<a href="https://allmcps.com/mcp/nikhilnt1234-tokenburnrate"><img src="https://allmcps.com/api/badge/nikhilnt1234-tokenburnrate?style=directory" alt="TokenBurnRate on AllMCPs" /></a>

Technical Specs & Signals

CategoryCloud Platforms

PricingFree

10/11 checks healthy over the last 32d

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools27/30

Adoption & activity3/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 22d ago via OSV.dev · token-tracker-mcp (npm)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in ☁️ Cloud Platforms →Best MCP servers for Cloud Platforms →Alternatives to TokenBurnRate →Install in Claude Desktop Install in Cursor Install in VS Code

TokenBurnRate

cost-trackingllmanalyticsdeveloper-tools

Local MCP server and CLI for tracking Claude, GPT, and Gemini token costs and identifying optimization savings.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "nikhilnt1234-tokenburnrate": {
      "command": "npx",
      "args": [
        "-y",
        "token-tracker-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Track API call costs across Claude, GPT, and Gemini

Review daily, weekly, or monthly token spending

Identify model, caching, context, and retry inefficiencies

Set spending limits for daily, weekly, or monthly budgets

Export usage records as CSV

Key features

Local SQLite usage storage

Automatic cost calculation

Ranked optimization hints with estimated monthly savings

Budget limits and spending summaries

Session and model cost rankings

CSV export

Capabilities & Tool Schemas (8)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by TokenBurnRate.

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

Documentation Overview

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.

Code

  ⬡ 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/month

Install

Terminal

npm install -g token-tracker-mcp

Or run without installing:

Terminal

npx token-tracker-mcp report

Add to Claude Desktop

bash

node scripts/setup.js

Or add manually to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

bash

git clone https://github.com/nikhilnt1234/TokenBurnRate.git
cd TokenBurnRate
npm install --ignore-scripts
npx tsup
npm test

Roadmap

Team / Supabase backend (multi-user shared dashboard)
Weekly email digest
Slack / webhook alerts
macOS menubar app

License

Read the full README →View source on GitHub →

Related MCP Servers

View all in Cloud Platforms View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

Package downloads in the last 30 days.

Last commit

3mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about TokenBurnRate

It tracks API calls, token usage, cache reads, models, sessions, and calculated costs for Claude, GPT, and Gemini usage.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/nikhilnt1234-tokenburnrate?style=directory)](https://allmcps.com/mcp/nikhilnt1234-tokenburnrate)

HTML Embed

<a href="https://allmcps.com/mcp/nikhilnt1234-tokenburnrate"><img src="https://allmcps.com/api/badge/nikhilnt1234-tokenburnrate?style=directory" alt="TokenBurnRate on AllMCPs" /></a>

Technical Specs & Signals

CategoryCloud Platforms

PricingFree

10/11 checks healthy over the last 32d

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools27/30

Adoption & activity3/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 22d ago via OSV.dev · token-tracker-mcp (npm)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in ☁️ Cloud Platforms →Best MCP servers for Cloud Platforms →Alternatives to TokenBurnRate →Install in Claude Desktop Install in Cursor Install in VS Code