Skip to main content

Overview

CostHawk monitors your usage patterns and alerts you when something unusual happens - before you get a surprise bill.

Alert Types

TypeDescription
Budget WarningApproaching a budget threshold (e.g., 80% of monthly budget)
Budget ExceededBudget limit has been exceeded
Cost SpikeUnusual increase in spending compared to baseline
Unusual ActivityAnomalous usage patterns detected
Error SpikeSudden increase in API errors
Rate LimitHitting provider rate limits

Viewing Alerts

Dashboard

The alerts page shows:
  • All recent alerts with severity indicators
  • Read/unread status
  • Detailed information about each alert

MCP Server

“List my unread alerts”
“Are there any cost anomalies?”

Anomaly Detection

CostHawk compares your recent activity to your baseline usage patterns to detect:
  • Cost spikes - Sudden increases in spending
  • Volume spikes - Unusual number of API calls
  • Model changes - Shift to more expensive models
  • Time anomalies - Activity at unusual times

Notification Channels

Get alerts delivered to:
  • Email - Default for all accounts
  • Slack - Via webhook integration
  • Discord - Via webhook integration
  • Microsoft Teams - Via webhook integration
  • PagerDuty - For on-call escalation
  • Custom Webhooks - Send to any URL

Setting Up Webhooks

Via the dashboard or MCP server:
“Create a Slack webhook for budget alerts at https://hooks.slack.com/services/…”
See Webhooks for detailed setup instructions.