Search / io.github.shahidh68/audit-ledger-mcp
audit-ledger-mcp
L0· runs locallyRecord AI decisions to a tamper-evident audit ledger from any MCP-compatible agent.
v0.3.1 · active · repository · descriptor JSON · versions
Search / io.github.shahidh68/audit-ledger-mcp
L0· runs locallyRecord AI decisions to a tamper-evident audit ledger from any MCP-compatible agent.
v0.3.1 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"audit-ledger-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"AUDIT_WRITE_KEY": "${AUDIT_WRITE_KEY}",
"AUDIT_READ_KEY": "${AUDIT_READ_KEY}",
"AUDIT_HMAC_KEY": "${AUDIT_HMAC_KEY}"
}
}
}
}claude mcp add audit-ledger-mcp -e "AUDIT_WRITE_KEY=${AUDIT_WRITE_KEY}" -e "AUDIT_READ_KEY=${AUDIT_READ_KEY}" -e "AUDIT_HMAC_KEY=${AUDIT_HMAC_KEY}" -- npx -y [email protected][mcp_servers.audit-ledger-mcp]
command = "npx"
args = ["-y", "[email protected]"]
env = { "AUDIT_WRITE_KEY" = "${AUDIT_WRITE_KEY}", "AUDIT_READ_KEY" = "${AUDIT_READ_KEY}", "AUDIT_HMAC_KEY" = "${AUDIT_HMAC_KEY}" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"audit-ledger-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"[email protected]"
],
"enabled": true,
"environment": {
"AUDIT_WRITE_KEY": "{env:AUDIT_WRITE_KEY}",
"AUDIT_READ_KEY": "{env:AUDIT_READ_KEY}",
"AUDIT_HMAC_KEY": "{env:AUDIT_HMAC_KEY}"
}
}
}
}{
"mcpServers": {
"audit-ledger-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"AUDIT_WRITE_KEY": "${AUDIT_WRITE_KEY}",
"AUDIT_READ_KEY": "${AUDIT_READ_KEY}",
"AUDIT_HMAC_KEY": "${AUDIT_HMAC_KEY}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=audit-ledger-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImF1ZGl0LWxlZGdlci1tY3BAMC4zLjEiXSwiZW52Ijp7IkFVRElUX1dSSVRFX0tFWSI6IiR7QVVESVRfV1JJVEVfS0VZfSIsIkFVRElUX1JFQURfS0VZIjoiJHtBVURJVF9SRUFEX0tFWX0iLCJBVURJVF9ITUFDX0tFWSI6IiR7QVVESVRfSE1BQ19LRVl9In19"
}{
"servers": {
"audit-ledger-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"AUDIT_WRITE_KEY": "${AUDIT_WRITE_KEY}",
"AUDIT_READ_KEY": "${AUDIT_READ_KEY}",
"AUDIT_HMAC_KEY": "${AUDIT_HMAC_KEY}"
}
}
}
}{
"mcpServers": {
"audit-ledger-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"AUDIT_WRITE_KEY": "${AUDIT_WRITE_KEY}",
"AUDIT_READ_KEY": "${AUDIT_READ_KEY}",
"AUDIT_HMAC_KEY": "${AUDIT_HMAC_KEY}"
}
}
}
}extensions:
"audit-ledger-mcp":
enabled: true
name: "audit-ledger-mcp"
type: stdio
cmd: "npx"
args:
- "-y"
- "[email protected]"
envs:
"AUDIT_WRITE_KEY": "${AUDIT_WRITE_KEY}"
"AUDIT_READ_KEY": "${AUDIT_READ_KEY}"
"AUDIT_HMAC_KEY": "${AUDIT_HMAC_KEY}"
timeout: 300
Placeholders to fill from your own secret store: ${AUDIT_WRITE_KEY}, ${AUDIT_READ_KEY}, ${AUDIT_HMAC_KEY}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulns1 advisory of lower severity or without a published fix: GHSA-5r4p-p66f-jhc7 in [email protected] (indirect, fixed in 4.13.11)deps.mcp_sdk_version@modelcontextprotocol/sdk 1.30.1 has 3 known advisories (GHSA-22jm-h49p-29qw, GHSA-6prh-2h8m-c8cw, GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.32.0 or laterdeps.resolvable[email protected] resolved: 98 packagesNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo ~liveness-unmeasured ~updated-137d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] npm97 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.30.1 · advisories checked 2026-10-20
| advisory | severity | package | fixed in |
|---|---|---|---|
| GHSA-22jm-h49p-29qwMCP TypeScript SDK: Experimental tasks were not tied to the session that created them | high | @modelcontextprotocol/[email protected]MCP SDK, direct | fixed in 1.32.0 |
| GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server | high | @modelcontextprotocol/[email protected]MCP SDK, direct | fixed in 1.31.0 |
| GHSA-6prh-2h8m-c8cwMCP TypeScript client SDK: HTTP client transports and OAuth requests followed cross-origin redirects and re-sent custom headers and request bodies | moderate | @modelcontextprotocol/[email protected]MCP SDK, direct | fixed in 1.32.0 |
| GHSA-5r4p-p66f-jhc7Hono: `serveStatic` decodes the request path a second time, leading to bypass of middleware on static paths | moderate | [email protected]indirect | fixed in 4.13.11 |
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
audit-ledger-mcp | npm | 0.3.1 | – | AUDIT_WRITE_KEY, AUDIT_READ_KEY, AUDIT_HMAC_KEY |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.shahidh68/audit-ledger-mcp",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.3.1",
"packages": [
{
"version": "0.3.1",
"transport": {
"type": "stdio"
},
"identifier": "audit-ledger-mcp",
"registryType": "npm",
"environmentVariables": [
{
"name": "AUDIT_API_URL",
"format": "string",
"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",
"format": "string",
"isSecret": true,
"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",
"format": "string",
"isSecret": true,
"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",
"format": "string",
"description": "HTTP timeout in milliseconds. Defaults to 5000."
},
{
"name": "AUDIT_RETRY_ATTEMPTS",
"format": "string",
"description": "Number of retry attempts on transient failures. Defaults to 3."
},
{
"name": "AUDIT_HMAC_KEY",
"format": "string",
"isSecret": true,
"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."
}
]
}
],
"repository": {
"url": "https://github.com/shahidh68/audit-ledger-mcp",
"source": "github"
},
"description": "Record AI decisions to a tamper-evident audit ledger from any MCP-compatible agent."
}