{
  "slug": "io-github-shahidh68-audit-ledger-mcp",
  "name": "io.github.shahidh68/audit-ledger-mcp",
  "title": "audit-ledger-mcp",
  "description": "Record AI decisions to a tamper-evident audit ledger from any MCP-compatible agent.",
  "version": "0.3.1",
  "publishedAt": "2026-06-05T20:32:47.667149Z",
  "updatedAt": "2026-06-05T20:32:47.667149Z",
  "repoUrl": "https://github.com/shahidh68/audit-ledger-mcp",
  "websiteUrl": null,
  "namespace": {
    "type": "github",
    "owner": "shahidh68"
  },
  "kind": "local",
  "packages": [
    {
      "registryType": "npm",
      "identifier": "audit-ledger-mcp",
      "version": "0.3.1",
      "transport": "stdio",
      "runtimeHint": null
    }
  ],
  "remotes": [],
  "envVars": [
    {
      "name": "AUDIT_API_URL",
      "isSecret": false,
      "isRequired": false,
      "description": "Your deployed audit-ledger API endpoint (e.g. https://<api-id>.execute-api.<region>.amazonaws.com/prod). Leave unset to run in sandbox mode against the public shared tenant."
    },
    {
      "name": "AUDIT_WRITE_KEY",
      "isSecret": true,
      "isRequired": false,
      "description": "Tenant write key for your deployed ledger. Required if AUDIT_API_URL is set and you want to call record_decision."
    },
    {
      "name": "AUDIT_READ_KEY",
      "isSecret": true,
      "isRequired": false,
      "description": "Tenant read key for your deployed ledger. Required if AUDIT_API_URL is set and you want to call verify_decision or list_decisions."
    },
    {
      "name": "AUDIT_TIMEOUT_MS",
      "isSecret": false,
      "isRequired": false,
      "description": "HTTP timeout in milliseconds. Defaults to 5000."
    },
    {
      "name": "AUDIT_RETRY_ATTEMPTS",
      "isSecret": false,
      "isRequired": false,
      "description": "Number of retry attempts on transient failures. Defaults to 3."
    },
    {
      "name": "AUDIT_HMAC_KEY",
      "isSecret": true,
      "isRequired": false,
      "description": "Tenant secret used to HMAC-SHA256 PII and prompts locally before sending. Generate once per tenant (e.g. node -e \"console.log(require('crypto').randomBytes(32).toString('hex'))\") and keep it in your environment. The key never leaves your process. If unset, the MCP falls back to plain SHA-256 for backwards compatibility and logs a one-time deprecation warning; set this to switch to keyed hashing, which regulators (ICO/EDPB) expect for pseudonymisation."
    }
  ],
  "category": "finance",
  "subcategory": "accounting",
  "company": "",
  "categoryAuto": true,
  "checks": [
    {
      "id": "source-linked",
      "label": "Source repository linked",
      "result": "pass",
      "detail": "https://github.com/shahidh68/audit-ledger-mcp"
    },
    {
      "id": "version-pinned",
      "label": "Version pinned",
      "result": "pass",
      "detail": "Every package has an explicit version"
    },
    {
      "id": "secrets-requested",
      "label": "Secrets requested",
      "result": "warn",
      "detail": "Asks for 3 secrets: AUDIT_WRITE_KEY, AUDIT_READ_KEY, AUDIT_HMAC_KEY"
    },
    {
      "id": "known-registry",
      "label": "Known package registry",
      "result": "pass",
      "detail": "All packages come from npm, PyPI, OCI, NuGet or MCPB"
    },
    {
      "id": "namespace",
      "label": "Namespace ownership",
      "result": "info",
      "detail": "Name verified via GitHub account shahidh68"
    },
    {
      "id": "meta-text",
      "label": "Registry text aimed at the AI",
      "result": "pass",
      "detail": "Description and settings contain no hidden characters or instructions to the AI"
    },
    {
      "id": "install-scripts",
      "label": "Install scripts",
      "result": "pass",
      "detail": "audit-ledger-mcp@0.3.1 runs nothing at install"
    },
    {
      "id": "code-flags",
      "label": "Code red flags",
      "result": "pass",
      "detail": "Read 18 files in audit-ledger-mcp@0.3.1: no obfuscation, encoded execution, credential reads or data-collection endpoints found"
    },
    {
      "id": "ai-text",
      "label": "Text aimed at the AI",
      "result": "pass",
      "detail": "No hidden characters or instructions to the AI in 18 files, including comments and the README"
    }
  ],
  "scannedAt": "2026-10-29",
  "level": "Scanned",
  "install": [
    {
      "label": "Claude Desktop (npm)",
      "kind": "claude_desktop_json",
      "text": "{\n  \"mcpServers\": {\n    \"audit-ledger-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"audit-ledger-mcp@0.3.1\"\n      ]\n    }\n  }\n}"
    }
  ],
  "curated": true,
  "stars": 1,
  "archived": false,
  "pushedAt": "2026-07-06T22:10:41Z",
  "health": {
    "score": 40,
    "parts": {
      "popularity": 0.20960793708526085,
      "activity": 0.33,
      "issues": null,
      "security": 0.8
    },
    "fail": 0,
    "warn": 1,
    "raw": {
      "stars": 1,
      "forks": 0,
      "downloads": 70,
      "hn": null,
      "issuesOpen": 0,
      "issuesClosed": 0,
      "prsMerged": 13,
      "commits90": 0,
      "release": null,
      "pushed": "2026-07-06T22:10:41Z",
      "growth": null,
      "growthDays": null,
      "archived": false
    },
    "at": "2026-10-31T07:42:38.200Z"
  }
}