# AgentLedger

> AgentLedger is a freemium MCP server for finance and payments. Hosted MCP server that meters, caps and logs what AI agents spend. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://aiagentscity.com
- **Repository:** https://github.com/entradox/agent-ledger
- **MCP Registry name:** io.github.entradox/agent-ledger
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-16

## About

Spend is recorded per agent_id across x402, MPP and API-key payment rails. Each agent gets a monthly budget cap and a report that flags spending anomalies, and the README frames the aim as proof of what every cent bought. Reads require either the agent's own secret or the workspace key; there is no unauthenticated read path.

A new workspace is minted from a /start page with no signup or card, and the key is shown once. The first track call for a new agent_id claims it and returns an agent_secret that authorises later writes. An autonomous agent with a wallet can instead create a workspace by paying through x402. A Python wrapper can sit around an OpenAI client so calls are metered automatically.

The same operator publishes related trust products on the same site, such as package scanning and agent health checks, but this entry covers the spend ledger.

## Features

- **Per-agent spend tracking:** Records spend by agent across x402, MPP and API-key rails.
- **Monthly budget caps:** Sets a cap in cents per agent that the ledger enforces.
- **Anomaly reports:** Reports per agent flag unusual spending.
- **Secret-based isolation:** Each agent has its own secret, and reads need a secret or the workspace key.
- **Wallet-based signup:** Agents with a wallet can create a workspace through an x402 payment.
- **Client wrapper:** A Python wrapper meters calls made through an OpenAI client.

## Good for

- Cap what a coding agent can spend per month
- Keep an audit trail of what agents bought
- Get alerts when an agent exceeds a daily amount
- Produce a weekly spend report for a fleet

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://aiagentscity.com/mcp/
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "agent-ledger": {
      "serverUrl": "https://aiagentscity.com/mcp/"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## FAQ

### Do I need an account?

No login or card. Opening /start creates a workspace and shows the workspace key once.

### What does the free tier include?

Three agents per workspace.

### How do clients connect?

Point any MCP client at the streamable-http address with no headers; Claude Code, Codex and Cursor examples are given.

### Can others read my agent's data?

Reports, tokens and alerts need the agent secret or the workspace key; missing or wrong credentials get a 401.

### Is AgentLedger free?

AgentLedger has a free plan, with paid plans for more usage or features.

### How do I add AgentLedger to Claude Code?

Run this command in your terminal: claude mcp add --transport http agent-ledger https://aiagentscity.com/mcp/

### What are the best alternatives to AgentLedger?

The closest alternatives to AgentLedger are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/agentledger
