Recordant MCP server

Recordant

<!-- mcp-name: io.github.recordant/recordant -->

Recordant is a patent-pending diagnostic + decisions-ledger engine for any host software system. Point it at a target's repo, changelog, and logs, and it runs a periodic scan that produces an operator brief: what changed, what looks broken, what was fixed, and a prioritized diagnosis list — plus a chat-native MCP console over the same data.

Bring your own LLM (Anthropic, OpenAI, or Gemini — your key, your usage, your bill). Recordant makes no provider assumption.

15-minute install and first brief

1. Install the package and your LLM provider's SDK (only the one you use):

pip install "recordant[anthropic]"     # or [openai], [gemini], or [all]

1. Copy recordant.example.toml to recordant.toml and set:

environment variable holding your key — never the key itself)

• repo_root — the target repo to diagnose
• changelog_path — usually CHANGELOG.md (falls back to git log if absent)
• log_globs — which log files to health-scan
• [llm] — your provider, model, and apikeyenv (the name of the

1. Export your key and run one cycle:

export RECORDANT_LLM_KEY=sk-...
   recordant --config recordant.toml

The brief path prints to stdout. The brief, snapshot, and (optional) decisions ledger are written under your configured output_dir.

schedule_seconds cadence in your config.

1. Schedule it (cron / systemd timer / your own scheduler) at the

That's the whole loop. See ENGINE.md for the adapter architecture, config reference, and known limitations.

MCP console

Recordant also runs as an MCP server exposing 7 tools over stdio, for use from a chat-native MCP client:

Token-auth is on by default — there is no anonymous mode. The server requires a valid RECORDANTLICENSEKEY and verifies it against the license service at startup before registering a single tool; it will not run unlicensed, even briefly. A short offline-grace window covers a transient network failure to the license service, but an explicitly invalid or expired key is refused immediately.

export RECORDANT_LICENSE_KEY=rk-...
recordant-mcp --config recordant.toml

Add it to your MCP client's config (Claude Desktop, Claude Code, etc.):

{
  "mcpServers": {
    "recordant": {
      "command": "recordant-mcp",
      "args": ["--config", "/absolute/path/to/recordant.toml"],
      "env": { "RECORDANT_LICENSE_KEY": "rk-..." }
    }
  }
}

Licensing and pricing

Recordant is licensed software, not open source (see LICENSE). Get a key and see current pricing at https://mentorsentinel.ai/markets-ai-governance.html.

Docker

Recordant ships as a compiled image -- there is no engine source to build from, so docker build is not part of a customer workflow. Pull the licensed image (published per BUILD-RELEASE.md) and run it:

docker pull recordant/recordant:<version>
docker run -v $PWD/recordant.toml:/app/recordant.toml:ro \
           -v $PWD/target-repo:/app/target-repo:ro \
           -e RECORDANT_LLM_KEY \
           recordant/recordant:<version> --config recordant.toml

The image is signed (cosign) and ships with an SBOM (syft) so you can audit what it does -- dependencies, egress -- without needing readable engine source; see BUILD-RELEASE.md for verification commands.

Shortened. The full README is on GitHub.