agent-costcenter-mcp

agent-costcenter-mcp

MCP server for per-agent cost attribution and budget management. Answer "which agent costs the most?" across your entire AI agent fleet.

Features

• Per-agent cost tracking — register agents, log LLM and tool calls, get per-agent spend
• Built-in pricing table — 11 models (Claude, GPT, Gemini, DeepSeek) with fuzzy name matching
• Budget management — set caps and alerts, check remaining budget, warn or block on overspend
• Cost reports — breakdown by agent, team, project, or all; includes model-level detail and percentages
• Anomaly detection — automatically flag agents with 2x+ spending spikes
• Model comparison — compare cost-per-1K-tokens across all models used

Quick Start

npx agent-costcenter-mcp

Claude Desktop

{
  "mcpServers": {
    "agent-costcenter": {
      "command": "npx",
      "args": ["agent-costcenter-mcp"]
    }
  }
}

Tools

Tool	Description
register_agent	Register agent with team, project, model, and budget cap
log_llm_call	Log an LLM call — auto-calculates cost from pricing table
log_tool_call	Log a tool/API call cost
get_cost_report	Cost breakdown by agent, team, project, or all
set_budget_alert	Set spending threshold (warn or block)
check_budget	Check if agent is within budget
get_cost_anomalies	Find agents with unusual spending spikes
compare_models	Compare cost efficiency across models

Resources

URI	Description
costcenter://summary	Current total spend across all agents
costcenter://pricing	Built-in model pricing table

Built-in Pricing (per 1M tokens)

Model	Input	Output
claude-opus-4	$15.00	$75.00
claude-sonnet-4	$3.00	$15.00
claude-haiku-4	$0.80	$4.00
gpt-4o	$2.50	$10.00
gpt-4o-mini	$0.15	$0.60
gpt-4.1	$2.00	$8.00
gpt-4.1-mini	$0.40	$1.60
gemini-2.5-pro	$1.25	$10.00
gemini-2.5-flash	$0.15	$0.60
deepseek-v3	$0.27	$1.10
deepseek-r1	$0.55	$2.19

Model names are fuzzy-matched (case-insensitive, strips version suffixes).

Example Workflow

1. register_agent(agent_id="researcher", team="discovery", model="claude-sonnet-4", budget_cap_usd=10)
2. log_llm_call(agent_id="researcher", model="claude-sonnet-4", input_tokens=5000, output_tokens=2000)
3. log_tool_call(agent_id="researcher", tool_name="web_search", duration_ms=1200, cost_usd=0.01)
4. check_budget(agent_id="researcher")
5. get_cost_report(scope="all")
6. get_cost_anomalies()
7. compare_models()

Development

npm install
npm test
npm run dev  # watch mode

License

MIT