Agent Cost Log
Cost per run, tool, model and day for AI agents, from one call or an OpenTelemetry export.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"costlog": {
"url": "https://costlog.cloudforbots.com/mcp"
}
}
}Remote endpoints
https://costlog.cloudforbots.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢log_costs(run_id, events, otel, price_in_per_m, price_out_per_m, ...)
Log what your agent's model and tool calls cost, then get the running total for the run and for today. Pass events (one per call, up to 500) or an OpenTelemetry OTLP/JSON trace export as otel (gen_ai.usage.input_tokens / output_tokens / gen_ai.request.model are read; trace id becomes run_id). Give cost_usd per call, or tokens plus your own per-million prices; nothing is guessed. Optional caps: run_cap_usd and daily_cap_usd. Free watch-only returns would_alert when a cap is crossed; Pro posts one alert per day to alert_webhook. Never blocks or changes your agent.
Input Schema
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"description": "Stable id for this run (default \"default\")."
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string",
"description": "Tool or step name, e.g. \"web_search\"."
},
"model": {
"type": "string",
"description": "Model name as your provider bills it."
},
"agent": {
"type": "string"
},
"input_tokens": {
"type": "integer"
},
"output_tokens": {
"type": "integer"
},
"cost_usd": {
"type": "number",
"description": "What the call cost, if your provider returns it. Otherwise pass tokens plus price_in_per_m / price_out_per_m."
},
"price_in_per_m": {
"type": "number",
"description": "Your input price in USD per 1M tokens (from your provider's price page)."
},
"price_out_per_m": {
"type": "number",
"description": "Your output price in USD per 1M tokens."
},
"run_id": {
"type": "string"
},
"at": {
"type": "string",
"description": "ISO time of the call (default now; at most 30 days back)."
}
}
}
},
"otel": {
"type": "object",
"description": "OTLP/JSON export: { resourceSpans: [...] }."
},
"price_in_per_m": {
"type": "number",
"description": "Default input USD per 1M tokens for events without cost_usd."
},
"price_out_per_m": {
"type": "number",
"description": "Default output USD per 1M tokens."
},
"run_cap_usd": {
"type": "number"
},
"daily_cap_usd": {
"type": "number"
},
"alert_webhook": {
"type": "string",
"description": "https URL Pro posts the cap alert to."
}
}
}⚪cost_report(run_id, days)
Cost per run, per tool, per model and per day. Without an API key pass run_id (one run). With a key: everything on that key. Free shows 7 days, Pro 30.
Input Schema
{
"type": "object",
"properties": {
"run_id": {
"type": "string"
},
"days": {
"type": "integer",
"description": "1-30 (free max 7)."
}
}
}🟢weekly_report
Plain-English summary of the last 7 days of spend: total, top runs, top tools, top models, busiest day. Read-only; sends nothing. Needs a free API key.
Input Schema
{
"type": "object",
"properties": {}
}🟢usage_and_upgrade
Show today's usage for your key or IP and the $9/month upgrade link. Free tier: 500 calls/day. Not metered.
Input Schema
{
"type": "object",
"properties": {}
}Community
Evidence