AI Usage MCP server
Reports real token usage and cost from Claude Code and OpenCode data. Nothing leaves your machine.
1 stars258 downloads/wk
Reviews
Write oneNobody has reviewed AI Usage yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
AI Usage tools (9)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
client_usageToken usage and cost per coding agent (Claude Code vs OpenCode).
counterfactual_costWhat the tokens from a period would have cost at another model’s list rates,
daily_usageToken usage and cost bucketed on the time axis, newest first. Use this for "how much
model_usagePer-model token usage and cost, highest token count first. Use this to answer
project_usagePer-project token usage and cost, highest token count first. A project is the working
recent_sessionsMost recently active sessions with project path, client, model(s), duration,
session_usageUsage for one session: client, model(s), duration, token breakdown and cost.
usage_breakdownToken usage and cost cut by two or more dimensions at once -- project x day,
usage_summaryTotal token usage and cost for a period, split by client (Claude Code, OpenCode).
Public scan report
scanner v0.1.8 · 2026-09-19 · same rubric, same numbers if you re-run it
- Code scan103 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Grade history
- 2026-09-19restoreB → Ascore 92
- 2026-09-19restoreC → Bscore 74: Shell command built from a string (injection risk)
Install directly
Runs npx -y ai-usage-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add ai-usage-mcp -- npx -y ai-usage-mcp
AI Usage: common questions
- Is AI Usage MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the AI Usage safety report
- How do I install AI Usage?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does AI Usage need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is AI Usage maintained?
- The last commit was 2 days ago (2026-09-18). The latest release is v0.9.0.