agentcost_previewLABSCO SUMMARY
The free tier answers the question most people actually have.
"Which model and which turns are eating the budget" is the preview, and it costs nothing. Pay only when you want the pattern detection and the recommendations on top. Worth knowing before you start: analysis reads your session logs, which contain your prompts — check what is in them before submitting real data, and use the sample report to see the shape first.
What it is
A spend analyser for AI agent session logs. It reads your Claude Code session files and reports what each model, tool and turn cost, so optimisation starts from measurement rather than a hunch.
What you get
agentcost_preview, free: total cost broken down by model, token counts split into input, output and cache, tool usage frequency, and the top 5 most expensive turnsagentcost_sample, free: a sample report, so you can see the output format before submitting real dataagentcost_analyze, paid: waste-pattern detection, per-tool cost attribution and optimisation recommendations at $5, or the same plus industry benchmarks, savings projections and an exportable report at $15
Requirements
The npm package alphaforensics-mcp, version 1.1.0, run as npx -y alphaforensics-mcp. No API key for the free preview tier. Your session logs live in ~/.claude/projects/. Paid analysis is charged through x402 micropayments on Base mainnet — no subscription and no key to manage.
Setup effort
One command — npx -y alphaforensics-mcp
USE CASES
01
Finding out what a week of agent work cost
Run the free preview over your session logs and see the split by model and by turn.
02
Working out which tool is expensive
Per-tool cost attribution shows where the tokens go, rather than a single total.
03
Seeing the output before handing over data
Pull the sample report first — it is free and needs nothing from you.
3 tools
Listed in project docs. Your client may show a different list.
agentcost_analyzeagentcost_sampleBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
npx on PATH
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y alphaforensics-mcpMCP Clients
Claude Desktop, Any MCP client
JSON
{
"mcpServers": {
"agentcost": {
"command": "npx",
"args": [
"-y",
"alphaforensics-mcp"
]
}
}
}
