get_usage_stats
View token usage statistics to verify savings from MCP Context Manager's efficient code retrieval, comparing tool usage against full file read costs.
Instructions
View token usage statistics for this session. Shows how many tokens each MCP tool used vs what full file reads would have cost. Use this to verify token savings.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reset | No | Reset usage stats after displaying. Default: false |
Implementation Reference
- src/index.ts:586-651 (handler)The 'get_usage_stats' tool implementation in the main switch statement of the tool handler. It calculates and reports the token usage statistics for the session.
case 'get_usage_stats': { const resetAfter = (args as any)?.reset || false; const elapsed = Math.round((Date.now() - sessionStartTime) / 1000); const minutes = Math.floor(elapsed / 60); const seconds = elapsed % 60; let totalMcpTokens = 0; let totalFullReadTokens = 0; let totalCalls = 0; let totalFiles = 0; let report = `š MCP Token Usage Stats (session: ${minutes}m ${seconds}s)\n`; report += `${'ā'.repeat(75)}\n`; report += `${'Tool'.padEnd(25)} ${'Calls'.padStart(6)} ${'Tokens'.padStart(8)} ${'Avg'.padStart(6)} ${'Files'.padStart(6)} ${'vs Read'.padStart(12)}\n`; report += `${'ā'.repeat(75)}\n`; for (const [tool, stats] of Object.entries(usageStats)) { totalMcpTokens += stats.totalTokens; totalFullReadTokens += stats.estimatedFullReadTokens; totalCalls += stats.calls; const fileCount = stats.filesReferenced.size; totalFiles += fileCount; const savings = stats.estimatedFullReadTokens > 0 ? `${Math.round((1 - stats.totalTokens / stats.estimatedFullReadTokens) * 100)}% saved` : 'n/a'; report += `${tool.padEnd(25)} ${String(stats.calls).padStart(6)} ${String(stats.totalTokens).padStart(8)} ${String(stats.avgTokensPerCall).padStart(6)} ${String(fileCount).padStart(6)} ${savings.padStart(12)}\n`; } report += `${'ā'.repeat(75)}\n`; report += `${'TOTAL'.padEnd(25)} ${String(totalCalls).padStart(6)} ${String(totalMcpTokens).padStart(8)} ${''.padStart(6)} ${String(allFilesReferenced.size).padStart(6)}\n`; report += `\nš Unique files touched: ${allFilesReferenced.size}\n`; if (totalFullReadTokens > 0) { const overallSavings = Math.round((1 - totalMcpTokens / totalFullReadTokens) * 100); report += `\nš If you Read those ${allFilesReferenced.size} files fully: ~${totalFullReadTokens.toLocaleString()} tokens\n`; report += `š MCP returned only relevant parts: ~${totalMcpTokens.toLocaleString()} tokens\n`; report += `š” Saved: ~${(totalFullReadTokens - totalMcpTokens).toLocaleString()} tokens (${overallSavings}%)\n`; } // List the actual files that were referenced if (allFilesReferenced.size > 0 && allFilesReferenced.size <= 30) { report += `\nš Files referenced:\n`; for (const file of allFilesReferenced) { const tokens = getFileTokenCount(file); report += ` ${file} (${tokens > 0 ? tokens.toLocaleString() + ' tokens' : 'unknown size'})\n`; } } else if (allFilesReferenced.size > 30) { report += `\nš Files referenced: ${allFilesReferenced.size} files (too many to list)\n`; } if (resetAfter) { for (const key of Object.keys(usageStats)) { delete usageStats[key]; } allFilesReferenced.clear(); sessionStartTime = Date.now(); report += `\nš Stats reset.`; } return { content: [{ type: 'text', text: report }], }; }