io.github.entradox/agent-ledger

up checked 2026-11-11T14:37:54.219Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

AgentLedger

Publisher-provided description

Meter, cap, and block AI agent spend before the provider is charged.

Summary by lookupd

Lets agents check, cap, and record their spending, with budget alerts, approvals, and spend reports before provider charges occur.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http agent-ledger https://aiagentscity.com/mcp/

Codex, remote (streamable-http)

codex mcp add agent-ledger --url https://aiagentscity.com/mcp/

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "agent-ledger": {
      "url": "https://aiagentscity.com/mcp/"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (18 tools)

Publisher-provided text

• ledger_rotate_secret Mint a NEW agent_secret for an agent_id your workspace already owns, invalidating the old one. Use this to RECOVER an agent whose secret was lost: the previous
• ledger_revoke_secret Invalidate an agent_id's agent_secret WITHOUT deleting its spend history. Use when a credential may have leaked, or to stop an agent writing. Subsequent writes
• ledger_track Record a spend entry for an AI agent on any payment rail, with optional token counts. Claiming a brand-new agent_id requires your workspace_key (get one via x4
• ledger_set_budget Set spending caps for an agent. Warns at 80%, blocks spend when exceeded — enforced: a ledger_track call that would cross the cap is rejected. Dollar caps (mon
• ledger_report Spend report for an agent over a rolling window. Returns total spend, breakdown by rail and by service, budget status (ok/warning/exceeded), detected anomalies
• ledger_proxy_attach Point your provider traffic at the proxy so budget caps are enforced BEFORE the provider is contacted, instead of being reported afterwards. This closes the ga
• ledger_alerts Alert history for an agent: budget warnings (80% threshold) and spending spikes. Requires a credential: either the agent's own agent_secret or its workspace's
• ledger_wait_events Long-poll an agent's event feed — how an agent with no public URL receives alerts. Webhooks (POST /v1/webhooks) push events to a URL you own; an agent on stdio
• ledger_check_spend Ask BEFORE you spend: may this agent spend this much right now? Returns allowed (true/false), a stable reason code (within_budget, over_monthly_cap, over_daily
• ledger_request_approval Ask your workspace owner for a one-shot spend exception before a ledger_track that the cap would refuse. Creates a pending permit for exactly amount_cents on t
• ledger_approvals List spend-approval permits — yours, or your whole workspace's.
• ledger_approval_decide Approve or deny a pending spend permit — workspace owner only. The agent's own agent_secret can REQUEST an approval but can never decide one: a credential that
• ledger_price What will this call cost? Priced from the same table the caps use. Exists because ledger_track requires the CALLER to supply amount_cents, so an agent whose sp
• ledger_start Get a FREE AgentLedger workspace with no credential and no arguments — the MCP equivalent of opening POST /start in a browser. Call this FIRST if you have no c
• ledger_api_docs Self-serve documentation for AgentLedger — quickstart, MCP tools, REST endpoints, budget caps, error codes, and idempotency usage, as markdown.
• ledger_examples Complete, runnable Python recipe for a common AgentLedger integration pattern.
• skills_list_tool List this product's skills. Each entry carries the SKILL.md URI, its name and description, verbatim frontmatter, and a per-file sha256 manifest. Read a body wit
• read_skill Read a product skill file by its skill:// URI.

Details

• Version: 0.4.7
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 413 ms
• First indexed: 2026-11-01T09:29:11.421Z
• Last seen in registry: 2026-11-01T09:29:11.588Z
• Repository: https://github.com/entradox/agent-ledger
• Website: https://aiagentscity.com

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.entradox/agent-ledger.svg)](https://lookupd.com/servers/io.github.entradox/agent-ledger)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp