# AgentLedger

Per-agent spend management — the Datadog for agent spending. Track spend
across x402/MPP/API-key rails, budget caps, anomaly alerts, audit trails.

Machine-readable schema: GET /openapi.json (OpenAPI 3) · MCP manifest: GET /server.json
Human/agent status page: GET /status

## Endpoints

GET  /health                       — liveness
POST /v1/track                     — record a spend entry
     body: {"agent_id": str, "rail": str, "amount_cents": int, "service": str,
            "tokens_in": int (optional), "tokens_out": int (optional), "model": str (optional)}
POST /v1/budget                    — set budget caps
     body: {"agent_id": str, "monthly_cents": int, "daily_cents": int (optional)}
GET  /v1/report/{agent_id}         — spend report (query: days=30)
GET  /v1/tokens/{agent_id}         — token burn report: in/out totals + by model (query: days=30)
GET  /v1/alerts/{agent_id}         — alerts for agent
GET  /v1/agents                    — list all tracked agents
GET  /stats                        — usage counters

## MCP

Registry: io.github.entradox/agent-ledger
Remote:   https://agent-ledger-production-0ff8.up.railway.app/mcp/

Tools exposed at POST /mcp/:
  ledger_track          — record a spend entry
  ledger_set_budget     — set a budget cap
  ledger_report         — get a spend report
  ledger_alerts         — get alerts for an agent
  ledger_list_agents    — list all tracked agents

Free during beta. Contact: entradox@icloud.com