audit-ledger-mcp 0.3.1 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +36 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -6,6 +6,14 @@ Built for teams shipping AI in regulated contexts: EU AI Act Article 12 logging,
6
6
 
7
7
  [![npm](https://img.shields.io/npm/v/audit-ledger-mcp.svg)](https://www.npmjs.com/package/audit-ledger-mcp) [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](./LICENSE) [![MCP](https://img.shields.io/badge/MCP-compatible-7c3aed.svg)](https://modelcontextprotocol.io)
8
8
 
9
+ > **The AI Audit Ledger family.** This MCP server *writes* decisions to the
10
+ > [ledger](https://github.com/shahidh68/audit-ledger) (what happened, tamper-evident). The
11
+ > [**AI Decision Evidence Hub**](https://github.com/shahidh68/evidence-hub) sits *above* it
12
+ > (read-only) and proves *audit-readiness* — what evidence each decision has, what's missing,
13
+ > who owns each gap, and a 0–100 score. Family:
14
+ > [audit-ledger](https://github.com/shahidh68/audit-ledger) · **audit-ledger-mcp** ·
15
+ > [evidence-hub](https://github.com/shahidh68/evidence-hub).
16
+
9
17
  **[Try the live dashboard →](https://d2pfirb2397ixy.cloudfront.net/?demo=1)**  ·  30 synthetic decisions written via this MCP server, queryable and verifiable.
10
18
 
11
19
  <p align="center">
@@ -304,6 +312,33 @@ List recent decisions for the calling tenant.
304
312
 
305
313
  ---
306
314
 
315
+ ## Companion: AI Decision Evidence Hub
316
+
317
+ This MCP server **writes** decisions to the ledger — the immutable record of *what
318
+ happened*. The **[AI Decision Evidence Hub](https://github.com/shahidh68/evidence-hub)**
319
+ is the read-only layer **above** the ledger that answers the next question an auditor
320
+ asks: *is each decision audit-ready?*
321
+
322
+ For every recorded decision it produces:
323
+
324
+ - an **audit-readiness score (0–100)** across nine evidence categories (model, data,
325
+ policy, human review, monitoring, prompt, integrity, retention, decision);
326
+ - exactly **what evidence is present vs missing**, and **who owns** each gap;
327
+ - an exportable, per-decision **audit pack** for regulators;
328
+ - a dashboard (cross-linked with the ledger's), plus a manifest-based resolver that
329
+ auto-fills static evidence.
330
+
331
+ It reads the ledger over its API and never modifies a record. Serverless on AWS
332
+ (Lambda + DynamoDB). See its
333
+ [Customer Guide](https://github.com/shahidh68/evidence-hub/blob/master/docs/CUSTOMER-GUIDE.md)
334
+ and [Admin Runbook](https://github.com/shahidh68/evidence-hub/blob/master/docs/ADMIN-RUNBOOK.md).
335
+
336
+ **The family:** [audit-ledger](https://github.com/shahidh68/audit-ledger) (what happened) ·
337
+ **audit-ledger-mcp** (this server — how agents write decisions) ·
338
+ [evidence-hub](https://github.com/shahidh68/evidence-hub) (audit-readiness).
339
+
340
+ ---
341
+
307
342
  ## Development
308
343
 
309
344
  ```bash
@@ -321,6 +356,7 @@ The server is TypeScript on Node 20+, ESM, stdio transport, using `@modelcontext
321
356
  ## Related
322
357
 
323
358
  - **[shahidh68/audit-ledger](https://github.com/shahidh68/audit-ledger)** — the AWS infrastructure this server talks to. CDK stack, Python and Node SDKs, compliance dashboard, full architecture documentation.
359
+ - **[shahidh68/evidence-hub](https://github.com/shahidh68/evidence-hub)** — the AI Decision Evidence Hub: the read-only audit-readiness layer above the ledger. Scores each decision's evidence, tracks gaps and owners, and generates audit packs. ([Customer Guide](https://github.com/shahidh68/evidence-hub/blob/master/docs/CUSTOMER-GUIDE.md) · [Admin Runbook](https://github.com/shahidh68/evidence-hub/blob/master/docs/ADMIN-RUNBOOK.md))
324
360
 
325
361
  ---
326
362
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "audit-ledger-mcp",
3
- "version": "0.3.1",
3
+ "version": "0.3.2",
4
4
  "description": "MCP server for AI Audit Ledger — record AI decisions to a tamper-evident ledger from any agent (Claude, Cursor, LangGraph, custom).",
5
5
  "mcpName": "io.github.shahidh68/audit-ledger-mcp",
6
6
  "type": "module",