Skip to content
MCP server

Sovereign Agent Logbook

Hash-chained, tamper-evident action log for AI agents, stored on your own server

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.1.3
Listing updated
today

Similar MCP servers

About Sovereign Agent Logbook

Sovereign Agent Logbook is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

Each logged event carries the hash of the previous one, so changing, inserting, removing or reordering a line makes logbook verify report exactly where the chain breaks. An entry records who acted, what, why, who approved it and the outcome, and every log_event call must name the agent, the model and the action so an auditor can see which model version did what. Values that look like passwords, tokens, API keys, IBANs or BSNs are masked before hashing.

The author frames it around EU AI Act record-keeping and human-oversight duties, noting that the Digital Omnibus on AI moved most high-risk deadlines to 2 December 2027, and says it helps with a verified timeline but not every article. A public test blocks outbound sockets and still completes a write, verify and export cycle. Exports come as JSON or CSV.

The log format is a separate Apache-2.0 spec. The README calls v0.1 a working skeleton. Run it over stdio from pip or as a Docker service; a hosted EU version at 29 euros a month is planned.

Install

Run in a terminal

claude mcp add sovereign-agent-logbook -- uvx sovereign-agent-logbook

Add to claude_desktop_config.json

{
  "mcpServers": {
    "sovereign-agent-logbook": {
      "command": "uvx",
      "args": [
        "sovereign-agent-logbook"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sovereign-agent-logbook": {
      "command": "uvx",
      "args": [
        "sovereign-agent-logbook"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "sovereign-agent-logbook": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "sovereign-agent-logbook"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sovereign-agent-logbook": {
      "command": "uvx",
      "args": [
        "sovereign-agent-logbook"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "sovereign-agent-logbook": {
      "command": "uvx",
      "args": [
        "sovereign-agent-logbook"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

log_event
Record an agent action with who, what, why, approval and outcome.
verify_logbook
Verify the hash chain and report where it breaks.
recent_events
Read the most recent events.
export_logbook
Export the logbook as JSON or CSV.

What it does

Hash-chained log
Tampering is detected and located by verification.
Secret masking
Passwords, tokens, API keys, IBANs and BSNs are masked before hashing.
No outbound network
A public test proves a full cycle with sockets blocked.
Audit export
JSON and CSV readable without the tool.
Open format spec
The log format is documented separately under Apache-2.0.
Skills pack
Teaches agents when to log and when to ask a human.

Good for

  • Keep an auditable record of an invoice-paying agent's actions
  • Reconstruct which tool call did what after an incident
  • Hand an auditor a CSV export of agent activity
  • Log scripted jobs through the logbook command line

Pricing

Open source

Apache-2.0; hosted version planned at 29 euros per month (not yet live)

Sovereign Agent Logbook FAQ

Does it send data anywhere?

No; it writes to a file on your server and a test checks it makes no outbound connections.

Which models work?

Any, because it speaks MCP.

What Python version is needed?

3.11 or newer.

Is there a hosted version?

One is planned at 29 euros a month with a 30-day trial.

Is Sovereign Agent Logbook free?

Yes. Sovereign Agent Logbook is open source, so you can use and self-host it for free.

How do I add Sovereign Agent Logbook to Claude Code?

Run this command in your terminal: claude mcp add sovereign-agent-logbook -- uvx sovereign-agent-logbook

What are the best alternatives to Sovereign Agent Logbook?

The closest alternatives to Sovereign Agent Logbook are REA, AiSOC, redamon, x64dbg-mcp-server and Agent Roast.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers