AgentLedger
Meter, cap, and block AI agent spend before the provider is charged
Reviews
No review yet. Used AgentLedger? Be the first to help others choose.What it does
AgentLedger is an MCP server, a connector that lets an AI assistant use it as a tool. It is hosted: an assistant connects to it over the internet, nothing to install.
No capability identified yet from its description.
Facts come from the Official MCP Registry, as declared by the publisher. Capabilities are matched automatically (low confidence). None of this is a test of the tool.
At a glance
How to connect
As declared in the Official MCP Registry · hosted endpoint tested by Electra Index 4h ago (live check)Hosted endpoint
https://aiagentscity.com/mcp/streamable-http
In Claude Code: claude mcp add --transport http agentledger https://aiagentscity.com/mcp/
MCP settings (Claude Desktop, Cursor and other MCP clients)
{
"mcpServers": {
"agentledger": {
"url": "https://aiagentscity.com/mcp/"
}
}
}Live check
Electra Index connected to the hosted endpoint 4h agoONLINE AgentLedger answered an MCP connection on 16 Nov 2026 and introduced itself as agent-ledger 0.4.7 (MCP protocol 2025-06-18).
18 tools offered to AI assistants
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 credential stops working immediately. Requires the workspace_key that owns agentledger_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 to that agent fail with agent_secret_mismatch until you rotate a new secret in.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 x402 at POST /v1/billing/x402 — no human, no login — or at /start). That first callledger_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 (monthly_cents/daily_cents) and token caps (monthly_tokens/ daily_tokens) are indepenledger_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, and entry count. Requires a credential: either the agent's own agent_secret orledger_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 gap where the brake was unreachable from MCP: an agent connected over MCP could recledger_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 workspace_key (same rule as GET /v1/alerts).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 MCP cannot host one, so it waits here instead. Call this in a loop: the call holledger_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_cap, over_monthly_token_cap, over_daily_token_cap, no_budget_set, unpriced_modelledger_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 the given service. The owner (a human, or a supervisor agent holding the workspaceledger_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 can approve its own requests is not a control. decision must be 'approve' or 'de
Show 6 more
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 spend is capped could under-report its own cost and stay under the cap. This returnledger_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 credentials yet. Every other tool here (ledger_track, ledger_set_budget, ledger_reledger_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 with `read_skill`.read_skill· Read a product skill file by its skill:// URI.
What "online" means: the server answered an MCP connection at the time of the check. It is not a guarantee of security, quality or continuous uptime. How we test: we open an MCP session and ask for the tool list, as an AI assistant would. We never run a tool and never send a key. Checked every few days. Method
Is this your server? Monitoring Pro: a check every 30 minutes and an email within the hour when it stops answering. Launch offer: $39.99 once, for life.
Facts & evidence
Each fact shows where it was seen and when.| Fact | Value | Evidence | Source | Last confirmed |
|---|---|---|---|---|
| Hosted endpoint | https://aiagentscity.com/mcp/ | DECLARED | SRC-001 Official MCP Registry | 23h ago |
| Version | 0.4.7 | DECLARED | SRC-001 Official MCP Registry | 23h ago |
| Local install (package) | no | DECLARED | SRC-001 Official MCP Registry | 23h ago |
| Remote access (hosted) | yes | DECLARED | SRC-001 Official MCP Registry | 23h ago |
| Website | https://aiagentscity.com | DECLARED | SRC-001 Official MCP Registry | 23h ago |
| Repository | https://github.com/entradox/agent-ledger | DECLARED | SRC-001 Official MCP Registry | 23h ago |
| Registry status | active | DECLARED | SRC-001 Official MCP Registry | 23h ago |
| MCP server | yes | DECLARED | SRC-001 Official MCP Registry | 23h ago |
Change history
- VERSION16 Oct 20260.4.6 → 0.4.7
- VERSION10 Oct 20260.4.3 → 0.4.6
- VERSION02 Oct 20260.4.1 → 0.4.3
Is this page accurate?
Flag it and our robot re-checks the official source. Reports never change a score.Is AgentLedger still online?
Free alerts · no account▲ 0Do you run AgentLedger? Know when it stops answering
For publishers · optionalIts hosted endpoint can be monitored. Monitoring Pro connects every 30 minutes like an AI assistant, emails you within the hour when it stops answering, keeps a 90-day availability history and adds your answer rate to your badge.
Monitoring never changes a score or a rank.
Questions about AgentLedger
How do I connect AgentLedger?
Use the hosted endpoint https://aiagentscity.com/mcp/ in your assistant's MCP settings. The exact settings are in "How to connect" above, as declared in the Official MCP Registry.
What tools does AgentLedger offer?
When Electra Index connected on 16 Nov 2026, it listed 18 tools: ledger_rotate_secret, ledger_revoke_secret, ledger_track, ledger_set_budget, ledger_report, ledger_proxy_attach, ledger_alerts, ledger_wait_events and more. The full list is in "Live check" above.
Is AgentLedger online?
Yes. Its hosted endpoint answered an MCP connection from Electra Index 4h ago.