MCP server that lets Claude, Cursor, LangGraph, and other agents write decisions to the audit ledger.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add audit-ledger --env AUDIT_WRITE_KEY='<AUDIT_WRITE_KEY>' --env AUDIT_READ_KEY='<AUDIT_READ_KEY>' --env AUDIT_HMAC_KEY='<AUDIT_HMAC_KEY>' --env AUDIT_API_URL='<AUDIT_API_URL>' -- npx -y audit-ledger-mcp~/.codex/config.toml
[mcp_servers.audit-ledger]
command = "npx"
args = ["-y", "audit-ledger-mcp"]
env = { AUDIT_WRITE_KEY = "<AUDIT_WRITE_KEY>", AUDIT_READ_KEY = "<AUDIT_READ_KEY>", AUDIT_HMAC_KEY = "<AUDIT_HMAC_KEY>", AUDIT_API_URL = "<AUDIT_API_URL>" }
# codex mcp add audit-ledger --env AUDIT_WRITE_KEY='<AUDIT_WRITE_KEY>' --env AUDIT_READ_KEY='<AUDIT_READ_KEY>' --env AUDIT_HMAC_KEY='<AUDIT_HMAC_KEY>' --env AUDIT_API_URL='<AUDIT_API_URL>' -- npx -y audit-ledger-mcp~/.cursor/mcp.json
{
"mcpServers": {
"audit-ledger": {
"command": "npx",
"args": [
"-y",
"audit-ledger-mcp"
],
"env": {
"AUDIT_WRITE_KEY": "<AUDIT_WRITE_KEY>",
"AUDIT_READ_KEY": "<AUDIT_READ_KEY>",
"AUDIT_HMAC_KEY": "<AUDIT_HMAC_KEY>",
"AUDIT_API_URL": "<AUDIT_API_URL>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"audit-ledger": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"audit-ledger-mcp"
],
"env": {
"AUDIT_WRITE_KEY": "<AUDIT_WRITE_KEY>",
"AUDIT_READ_KEY": "<AUDIT_READ_KEY>",
"AUDIT_HMAC_KEY": "<AUDIT_HMAC_KEY>",
"AUDIT_API_URL": "<AUDIT_API_URL>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"audit-ledger": {
"command": "npx",
"args": [
"-y",
"audit-ledger-mcp"
],
"env": {
"AUDIT_WRITE_KEY": "<AUDIT_WRITE_KEY>",
"AUDIT_READ_KEY": "<AUDIT_READ_KEY>",
"AUDIT_HMAC_KEY": "<AUDIT_HMAC_KEY>",
"AUDIT_API_URL": "<AUDIT_API_URL>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"audit-ledger": {
"command": "npx",
"args": [
"-y",
"audit-ledger-mcp"
],
"env": {
"AUDIT_WRITE_KEY": "<AUDIT_WRITE_KEY>",
"AUDIT_READ_KEY": "<AUDIT_READ_KEY>",
"AUDIT_HMAC_KEY": "<AUDIT_HMAC_KEY>",
"AUDIT_API_URL": "<AUDIT_API_URL>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"audit-ledger": {
"command": "npx",
"args": [
"-y",
"audit-ledger-mcp"
],
"env": {
"AUDIT_WRITE_KEY": "<AUDIT_WRITE_KEY>",
"AUDIT_READ_KEY": "<AUDIT_READ_KEY>",
"AUDIT_HMAC_KEY": "<AUDIT_HMAC_KEY>",
"AUDIT_API_URL": "<AUDIT_API_URL>"
}
}
}
}Environment variables
AUDIT_WRITE_KEYAUDIT_READ_KEYAUDIT_HMAC_KEYAUDIT_API_URL
Replace the placeholders with your own credentials and keep them out of version control.