agent-cost-mcp

MCP server that tracks AI agent token usage and spending in real time. Budget alerts, per-task cost breakdown, visual dashboard, daily/weekly/monthly reports.

Works with any MCP client: Claude Code, Cursor, Windsurf, Codex, Gemini CLI, and more.

[](LICENSE) [](https://python.org) [](https://modelcontextprotocol.io)

Every developer using AI agents worries about spending. Most tools don't tell you what each message costs until the bill arrives.

This MCP server tracks it in real time — per message, per model, per day. Set a budget, get alerts, see exactly where your money goes.

• Visual dashboard — dark-themed web UI with spending charts, budget gauges, and activity log
• Per-message cost logging — see what each AI interaction costs instantly
• Budget alerts — warns when approaching daily/monthly limits
• Cost reports — today, this week, this month, all time
• Model breakdown — donut chart showing which model eats your budget
• Spending trends — 14-day bar chart with color-coded spending
• 15+ models supported — Claude, GPT, DeepSeek, Gemini, Llama
• Estimate before running — check cost before expensive tasks
• Local storage — all data stays on your machine (~/.agent-cost-mcp/)
• Auto-refresh — dashboard updates every 30 seconds

pip install agent-cost-mcp

Or with uv:

uv pip install agent-cost-mcp

Claude Code — add to ~/.claude/settings.json:

{
  "mcpServers": {
    "agent-cost": {
      "command": "agent-cost-mcp"
    }
  }
}

Cursor — add to .cursor/mcp.json:

{
  "mcpServers": {
    "agen