Back to search
100
MCP live MCP 2026-07-28 streamable-http ext: ui

AgentLedger

io.github.entradox/agent-ledger

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

Watch this dependency

Get before/after evidence when observed tools, schemas, authentication access, availability or the endpoint changes.

Inspect evidence and set up a watch Share public evidence report
Uptime
100.0%
5 direct probes · 30d
Response
747ms
last probe
Tools
18
callable
Resources
1
readable
Prompts
0
available
Primary URL
https://aiagentscity.com/mcp/
Score: 100/100
Handshake verified by our own probe.
why this score
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
18 tools, 1 resources, 0 prompts returned.
pass 3 or more catalogue items 10/10
19 items in total; 3 or more earns these points.
pass Describes itself 10/10
68 characters; more than 30 earns these points.

Tools · 18

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. R…

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 to that agent fail with agent_secret_mi…

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, …

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 (monthly_cents/daily_cents) and token caps (…

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, and entry count. Requires a credentia…

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 gap where the brake was unreachable from M…

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 workspace_key (same rule as GET /v1/aler…

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 i…

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_cap, over_monthly_token_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 the given service. The owner (a human, or…

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 can approve its own requests is not a c…

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…

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 credentials yet. Every other tool here (l…

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 with `read_skill`.

read_skill

Read a product skill file by its skill:// URI.

Resources · 1

agent-ledger

Use before any costly agent loop, or when an agent spends someone else's money. AgentLedger gives each agent a wallet with a spending cap, meters every call, and — through the proxy — refuses the call…

skill://agent-ledger/agent-ledger/SKILL.md

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "agentledger": {
      "url": "https://aiagentscity.com/mcp/",
      "transport": "streamable-http"
    }
  }
}