This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
An MCP server that surfaces your Claude Code token usage, estimated cost, and
plan-limit status in any MCP client (Zed, Claude Desktop, Cursor, and others). It
reads Claude Code's own logs (~/.claude/projects/**/*.jsonl) and Anthropic's usage
API, then exposes the data as tools the agent can call.
Published on npm as claude-code-usage-mcp
and in the official MCP registry as
io.github.wheelbarrel00/claude-code-usage.
Two tools:
get_claude_usage — today's cost and tokens, 5-hour and weekly plan-limit
utilization (with reset times and a pace projection), recent burn rate, current
context-window fill, and pay-as-you-go extra usage.
get_usage_breakdown — usage grouped by model, project, session, or git
branch, or over time (daily this month / monthly all-time).
Ask the agent things like "what's my Claude usage right now?" or "break down my Claude spend by project this month." MCP tools are queried on demand — there's no persistent status-bar display.
Related MCP server: skillfm-claude-code-token-usage-mcp
npx -y claude-code-usage-mcpRegister it with your client. For Zed (settings.json):
{
"context_servers": {
"claude-code-usage": {
"command": "npx",
"args": ["-y", "claude-code-usage-mcp"]
}
}
}For Claude Desktop (claude_desktop_config.json), use the same command under
"mcpServers" instead of "context_servers".
An authenticated Claude Code install — the server reads ~/.claude/.credentials.json
and ~/.claude/projects, the same files the CLI writes.
Optional environment variables:
Variable | Default | Meaning |
|
| ISO currency code for cost formatting. |
|
| Decimal places for cost figures. |
|
| Fetch live limits from Anthropic; falls back to the on-disk cache. |
|
| Minimum seconds between live usage requests. |
|
| Trailing window for the burn-rate calculation. |
|
|
|
|
| Override the Claude Code config directory. |
Live plan limits come from api.anthropic.com/api/oauth/usage using the OAuth token
already on disk; the access token is refreshed in memory only, so a running Claude
Code session is never logged out. Token and cost figures are parsed from the local
session logs.
mcp-server/ — the MCP server (TypeScript, bundled to dist/server.mjs).
extension.toml, Cargo.toml, src/lib.rs — a self-contained Zed extension that
embeds and launches the server (an alternative to the npx install above).
cd mcp-server
npm install
npm run build # bundles to dist/server.mjs
node dist/server.mjs --selftestThe Zed extension embeds the bundled server and launches it with Zed's own Node.
Build the server first, install rustup and the WebAssembly
target (rustup target add wasm32-wasip1), then in Zed open Extensions → Install
Dev Extension and select this repository's root folder.
MIT
This server cannot be deployed
A paid remote MCP for OpenAI Codex agent coordination MCP, built to return verdicts, receipts, usage
Analytics for MCP servers. Query your tool calls, first-call success, retries and schema cost.
Veqen brings together work and coding agent costs per person and team, product inference costs per customer, agent spending, protection incidents, invoice checks, chargeback and the month-end close. Ask your assistant to investigate recorded spending, compare model prices, review provider keys and incidents, record bills and credits, or manage budgets, alerts, teams and spending policies. Your account role and plan govern access. Provider-key shut-off and agent-card controls require the appropriate role and provider permissions. Destructive actions require confirmation, and organizations can require a second person to approve a shut-off. SDK budget blocking is not a guaranteed spending cap. Work and coding agents are free for up to 3 people; product inference is free up to $1,000 in monthly AI spend. Connect your Veqen account for private organization data. The separate public model-price server needs no account. Estimates remain separate from provider invoices. Setup and permissions: https://veqen-app.com/docs/mcp
Veqen brings together work and coding agent costs per person and team, product inference costs per customer, agent spending, protection incidents, invoice checks, chargeback and the month-end close. Ask your assistant to investigate recorded spending, compare model prices, review provider keys and incidents, record bills and credits, or manage budgets, alerts, teams and spending policies. Your account role and plan govern access. Provider-key shut-off and agent-card controls require the appropriate role and provider permissions. Destructive actions require confirmation, and organizations can require a second person to approve a shut-off. SDK budget blocking is not a guaranteed spending cap. Work and coding agents are free for up to 3 people; product inference is free up to $1,000 in monthly AI spend. Connect your Veqen account for private organization data. The separate public model-price server needs no account. Estimates remain separate from provider invoices. Setup and permissions: https://veqen-app.com/docs/mcp
