@agledger/mcp-server

The official MCP server for the AGLedger API — accountability infrastructure for AI agents. The Layer 3 accountability layer of the agent stack.

Connects any MCP-compatible AI agent (Claude, Cursor, Windsurf, etc.) to the AGLedger API with 2 universal API-pass-through tools plus an offline audit verifier. No SDK code required — just point your agent at this server.

Learn more

• agledger.ai — what AGLedger is and why Layer 3 accountability matters
• How it works — the four-endpoint lifecycle: record, receipt, verdict, fulfill
• Glossary — canonical definitions of Record, Receipt, Verdict, Settlement Signal
• MCP Server guide — installation and agent workflow
• Protocol (AOAP) — the coordination language behind AGLedger

Install

npm install -g @agledger/mcp-server

Quick Start

Add to your MCP client configuration (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "agledger": {
      "command": "agledger-mcp",
      "args": ["--api-key", "your-api-key"]
    }
  }
}

Or run directly:

agledger-mcp --api-key <key> [--api-url <url>]

Tools

| Tool | Description | |------|-------------| | agledger_discover | Returns API health, your identity, available scopes, and a quickstart workflow. Call this first. | | agledger_api | Make any AGLedger API call (method, path, params). The API returns nextSteps on every response for self-guided workflow discovery. | | agledger_verify | Verify a record audit export offline (RFC 8785 hash chain + Ed25519 signatures). No network calls. Returns valid, verifiedEntries, and a brokenAt pointer on failure. |

Agent workflow

The agledger_discover tool returns a quickstart workflow that guides agents through the accountability flow:

1. GET /v1/schemas -- list available Record types
2. GET /v1/schemas/{type} -- get required fields and examples
3. POST /v1/records -- create a record
4. POST /v1/records/{id}/receipts -- submit evidence when done

Every API error response includes a suggestion field with actionable recovery guidance -- agents can self-correct without human intervention.

Configuration

| Flag | Env Var | Description | |------|---------|-------------| | --api-key | AGLEDGER_API_KEY | AGLedger API key (required) | | --api-url | AGLEDGER_API_URL | API base URL (default: https://agledger.example.com) |

What is AGLedger?

AGLedger is the accountability layer for automated operations. It records what was agreed to, by whom, when -- and tracks the delegation of that agreement through other systems.

• Records -- structured commitments with acceptance criteria and tolerance bands
• Receipts -- task attestations recording what was reported to be done
• Verdicts -- principal acceptance decisions (PASS/FAIL) with settlement signals
• Audit trail -- hash-chained, Ed25519-signed, tamper-evident chain

Learn more at agledger.ai | API docs

Each self-hosted AGLedger instance also serves interactive Swagger UI at {AGLEDGER_API_URL}/docs.

Requirements

• Node.js >= 22
• A running self-hosted AGLedger API instance and an API key (see the self-hosted install guide at agledger.ai)

License

Proprietary. See LICENSE.

AGLedger, Agentic Ledger, Settlement Signal, and Agentic Operations and Accountability Protocol (AOAP) are trademarks of AGLedger LLC. Patent pending.