Insights
Cost intelligence — daily breakdown, waste detection, optimization, and forecasting.
Overview
The Insights resource provides cost intelligence: daily spend aggregation, waste detection (over-qualified models, duplicate requests), optimization recommendations, and budget forecasting with anomaly detection.
Methods
daily()
Get daily cost aggregation with per-model breakdown. Returns status: "warming_up" until enough data is collected.
const daily = await client.insights.daily();
// { status: "ready", date: "2026-03-01", summary: { requestCount: 100, totalCostUsd: 1.5, ... }, models: [...] }daily = client.insights.daily()
# daily["summary"]["totalCostUsd"] # => 1.5waste()
Detect wasted spend: over-qualified model usage and duplicate requests.
const waste = await client.insights.waste();
// { status: "ready", estimatedWasteUsd: 2.30, overQualifiedModels: [...], duplicateRequests: [...] }waste = client.insights.waste()
# waste["estimatedWasteUsd"] # => 2.30optimize()
Get model optimization recommendations based on usage patterns.
const recs = await client.insights.optimize();
// { status: "ready", suggestions: [{ currentModel: "...", recommendation: { suggestedModel: "...", estimatedSavings: "40%", reason: "..." } }] }recs = client.insights.optimize()
# recs["suggestions"][0]["recommendation"]["suggestedModel"]forecast(options?)
Get budget forecasting with anomaly detection.
| Parameter | Type | Description |
|---|---|---|
budget | number | Budget amount in USD |
period | string | Forecast period ("daily", "monthly") |
const forecast = await client.insights.forecast({ budget: 100, period: "monthly" });
// { status: "ready", forecast: { avgDailySpendUsd: 5.0, trend: "stable", confidence: 0.85, projectedPeriodSpendUsd: 50, daysRemaining: 22 }, anomalies: [] }forecast = client.insights.forecast(budget=100.0, period="monthly")
# forecast["forecast"]["projectedPeriodSpendUsd"] # => 50MCP Tools
| Tool | Description | Permission |
|---|---|---|
br_get_insights | General optimization insights | audit.read |
br_get_insights_daily | Daily cost breakdown | audit.read |
br_get_insights_forecast | Budget forecasting | audit.read |