MCP Server
Ask Claude about your Claude Code usage in natural language. The MCP server provides 12 tools that Claude can call to answer questions about your spending, rate limits, trends, and anomalies.
Overview
Instead of opening the dashboard, just ask Claude:
- "How much did I spend this week?"
- "Compare my usage this week vs last week"
- "Any anomalies in my spending?"
- "What's my forecast for the next 7 days?"
Claude calls the appropriate MCP tool and summarizes the results.
Example: Deep Analysis
Ask Claude in Claude Code: "Faz uma análise completa do meu uso: tendência, anomalias e forecast" — the MCP server returns rich, formatted analysis using multiple analytics tools:
● Análise Completa de Uso
1. Tendência (últimos 30 dias)
┌───────────────────────────┬─────────────────────────────┐
│ Métrica │ Valor │
├───────────────────────────┼─────────────────────────────┤
│ Direção │ UP (+$2.91/dia) │
│ Custo médio diário │ $107.00 │
│ 1ª metade do período │ $80.03/dia │
│ 2ª metade do período │ $133.96/dia (+67.4%) │
│ Projeção 7 dias │ $1,104.82 ($157.83/dia) │
└───────────────────────────┴─────────────────────────────┘
O uso cresceu significativamente na segunda metade do mês,
quase dobrando em relação à primeira.
2. Anomalias (últimos 14 dias)
Apenas 1 anomalia detectada (threshold: 2x desvio padrão):
┌──────────────────┬─────────┬──────────────┬─────────┐
│ Data │ Custo │ Desvio │ Z-score │
├──────────────────┼─────────┼──────────────┼─────────┤
│ 2026-04-08 │ $291.33 │ +$158.06 │ +2.0 │
└──────────────────┴─────────┴──────────────┴─────────┘
Ontem foi um dia atípico — o custo foi mais que o dobro
da média recente ($133/dia).
3. Forecast (próximos 7 dias)
┌───────────────────────────┬─────────────────────────────┐
│ Métrica │ Valor │
├───────────────────────────┼─────────────────────────────┤
│ Total previsto │ $571.27 │
│ Média diária prevista │ $81.61/dia │
│ Tendência do forecast │ -$4.70/dia (queda) │
│ Faixa de confiança │ $44.65 — $1,113.72 │
└───────────────────────────┴─────────────────────────────┘
Resumo
— O uso está em tendência de alta no mês, mas o forecast
aponta correção para baixo.
— O spike de ontem ($291) é o principal ponto de atenção.
— A faixa de confiança é ampla ($44–$1,113), refletindo
alta volatilidade no uso recente.Data Tools (7)
These tools retrieve raw usage data:
| Tool | What It Returns |
|---|---|
get_daily_usage | Token counts, costs, and session counts per day |
get_weekly_usage | Weekly aggregated metrics |
get_active_blocks | Currently active 5-hour blocks with remaining capacity |
get_rate_limits | 5-hour and weekly rate limit usage percentages |
get_machines | Connected machines with status (Online/Idle/Offline) |
get_projects | Usage breakdown by project directory |
get_plan_savings | Subscription cost vs API-equivalent cost comparison |
Analytics Tools (5)
These tools perform analysis on your data:
compare_periods
Compare two time periods side by side. Supported periods: today, yesterday, this_week, last_week, this_month, last_month.
Returns: cost diff, token diff, percentage change, and top 3 project movers.
get_trends
Linear regression on daily costs with direction detection.
Returns: direction (UP/DOWN/STABLE), daily slope ($/day), 7-day projection, first half vs second half comparison.
detect_anomalies
Z-score based anomaly detection on daily costs.
Returns: list of anomalous days (z-score > threshold), sorted by deviation. Configurable threshold (default: 2.0).
compare_projects
Side-by-side comparison of two or more projects.
Returns: tokens, costs, session counts, and model distribution per project.
get_cost_forecast
Moving average forecast for the next 7 days.
Returns: predicted daily costs with low/high confidence range based on historical variance.
Setup
cc-telemetry setup-mcpSee the MCP Integration Guide for full setup instructions and troubleshooting.