
TokenTrace
Connects Claude to your local AI CLI usage analytics through stdio transport. Exposes tools for scanning local logs and SQLite databases from tools like Cursor and Cline, then returns token counts, cost breakdowns, and confidence labels as JSON. The get_agent_guide tool serves as the entry point with workflow instructions and privacy guardrails. Scan operations require explicit confirmation flags before touching files. You'd reach for this when building agents that need visibility into their own token usage patterns or when you want programmatic access to the same local-first analytics that TokenTrace's dashboard provides. All data stays on your machine, no telemetry or cloud accounts required.
- tools
- 2
- transport
- STDIO
- last updated
- Jun 26, 2026
Tools
2 toolsPublic tool metadata for what this MCP can expose to an agent.
get_agent_guideFirst MCP call for agents.
First MCP call for agents.
No parameter schema in public metadata yet.
get_preflightCheck readiness before another coding-agent run with local scan freshness, confidence, guardrail, anomaly, and repair findings.
Check readiness before another coding-agent run with local scan freshness, confidence, guardrail, anomaly, and repair findings.
No parameter schema in public metadata yet.
Sponsors
Readme
TokenTrace logo
TokenTrace CLI
Local-first AI CLI usage analytics for developers and coding agents.
TokenTrace answers one practical question before the next expensive AI CLI run: is your local usage evidence ready to trust? It scans local Claude Code, Codex, structured usage logs, and usage-shaped local databases, then labels token and cost data as exact, estimated, unknown, cached, or non-cache. The dashboard opens on Today, with direct paths into Sessions, Evidence, and Fix Data.
TokenTrace is designed for local development machines first, with macOS-oriented defaults. It does not require a cloud account and does not send telemetry or logs anywhere.
TokenTrace Today dashboard
What TokenTrace Helps You Do
Details
- Repository
- github.com/abhiyoheswaran1/tokentrace
- Website
- www.baseframelabs.com/apps/tokentrace
- Category
- Monitoring & Observability
- Package
tokentrace- Transport
- STDIO
- Registry
- MCP registry, active