MCP server

AgentLedger

io.github.entradox/agent-ledger

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

18

Token cost

About 5,581 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.agent-ledger]
url = "https://aiagentscity.com/mcp/"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"agent-ledger":{"type":"http","url":"https://aiagentscity.com/mcp/"}}}

Antigravity

agy mcp add agent-ledger https://aiagentscity.com/mcp/

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"agent-ledger","server_url":"https://aiagentscity.com/mcp/","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"agent-ledger","server_url":"https://aiagentscity.com/mcp/"}

Tools

• ledger_alerts ~187 tokens
  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_api_docs ~146 tokens
  Self-serve documentation for AgentLedger — quickstart, MCP tools, REST endpoints, budget caps, error codes, and idempotency usage, as markdown.
• ledger_approval_decide ~274 tokens
  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 'deny'; only pending permits can be decided. An approved permi
• ledger_approvals ~194 tokens
  List spend-approval permits — yours, or your whole workspace's.
• ledger_check_spend ~450 tokens
  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_model), a one-line message, the cost estimate, the price used (w
• ledger_examples ~104 tokens
  Complete, runnable Python recipe for a common AgentLedger integration pattern.
• ledger_price ~341 tokens
  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 returns the number the enforcement path would use, so an agent ca
• ledger_proxy_attach ~338 tokens
  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 record spend (ledger_track) but nothing could refuse a call. W
• ledger_report ~242 tokens
  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 or its workspace's workspace_key (same rule as GET /v1/report
• ledger_request_approval ~402 tokens
  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 workspace_key) approves or denies it with ledger_approval_decide. An
• ledger_revoke_secret Changes accounts · ~200 tokens
  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. The agent_id stays claimed, so no other workspace can claim
• ledger_rotate_secret ~248 tokens
  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 agent_id — an agent's own agent_secret cannot rotate itself, bec
• ledger_set_budget ~538 tokens
  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 independent dimensions: dollar caps only cover non-"tokens" rails,
• ledger_start ~353 tokens
  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_report, ledger_alerts) needs a workspace_key or an agent_secr
• ledger_track ~612 tokens
  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 call mints an agent_secret and returns it in the response — sav
• ledger_wait_events ~778 tokens
  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 holds open up to `timeout` seconds (max 30) and returns when e
• read_skill ~88 tokens
  Read a product skill file by its skill:// URI.
• skills_list_tool ~86 tokens
  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`.

Browse

• Claude tools
• GitHub tools
• Website monitoring
• Converting to Markdown
• Payments
• Invoicing and accounting

Related MCP servers

• Biii
  Fail-closed safe-to-pay verdicts on Base: known-bad wallets, look-alike tokens, repeat rug funders.
• TERM
  A forum whose members are AI agents. Publish verifiable findings, enter scored challenges.
• CueFrame
  Turn footage into finished video: reframing, captions behind the subject, motion graphics, renders.
• Launchfiles
  Launchfiles hosted MCP: free page radars (design UX, search repair, deploy trust) + workspace tools.
• SIMcloud
  South African MCP server for airtime, data, SMS, VAS, electricity, balance, and network lookup.
• mcp.market gateway
  Search 33,000+ MCP servers by job, see safety grades and reviews, and call them from one endpoint.
• Routavo
  Any API, four tools: discover, call with routing and signed receipts, verify, dispute.
• Spendline
  Enforce AI budgets before the model call and track cost per customer across 10 providers.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.entradox/agent-ledger.svg)](https://aptlynx.net/servers/io.github.entradox/agent-ledger)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents