# Agent Cost Lens

> Token cost analysis for AI agents on the Claude / Anthropic API: spend
> visibility, cache-waste detection, and simulated recovery estimates.
> Local scrub, metadata-only upload, audit-before-send. $29/month.

## What it does
- Reads agent usage locally (Claude Code transcripts or apilog-v1 JSONL).
- Pseudonymizes source/session names on the client; prompt text is never
  collected (the wire schema has no field for it).
- Hosted analyzer returns: total spend, spend by model/day/source, cache-hit
  rate, and "fix recovers up to $X (simulated)" with per-pattern advice.

## Start
1. Buy a key (https://buy.stripe.com/28E28tdxI4Sze1U2FwaR200) — Stripe checkout, key shown once on the claim page.
2. Download the MCP client: https://lens.r-lattice.com/download
3. pip install agent_cost_lens_mcp-0.1.0.tar.gz; register `acl-mcp` as an MCP server with env
   LENS_SERVER_URL=https://lens.r-lattice.com and your
   LENS_API_KEY.
4. Tools exposed: `preview_upload` (audit what would be sent; needs no key),
   `analyze_costs` (runs the analysis).

## API (for direct integrations)
- POST /v1/analyze — Bearer key auth; body {"schema": "apilog-v1",
  "events": [...]} (usage metadata only); returns summary + advice JSON.
- GET /v1/health — liveness.

## Honesty notes
- All recovery figures are simulated upper bounds, labeled as such.
- Cancellation via Stripe deactivates the key automatically.