citadeldb-mcp

mcp-name: dev.citadeldb/mcp

Model Context Protocol (MCP) server for the Citadel encrypted memory engine. Gives any MCP client (Claude Desktop, an IDE, an agent) persistent, encrypted memory.

Memory lives in a local citadeldb-mem region: AES-256 encrypted at rest, per-atom sealed and HMAC-authenticated, recalled through a hybrid vector + keyword + recency + importance fusion over a PRISM approximate nearest-neighbor index, connected by a typed edge graph, and forgotten by destroying keys (cryptographic erasure).

Install

Run it with no install:

uvx citadeldb-mcp --db memory.cdl

Or install the command with pip install citadeldb-mcp or cargo install citadeldb-mcp, then wire it into Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "citadel": {
      "command": "citadeldb-mcp",
      "args": ["--db", "memory.cdl", "--embedder", "bge-large"],
      "env": { "CITADEL_KEY": "your-passphrase" }
    }
  }
}

Omit --embedder for keyword-only recall, or run citadeldb-mcp pull bge-large first for semantic recall (models are never downloaded automatically; see below).

Tools (over a synchronous, hand-rolled JSON-RPC 2.0 stdio transport):

mem_recall - hybrid retrieval (vector + keyword + recency + importance); filter by kind/payload, expand along the memory graph, override fusion weights, and optionally attach provenance (derived_from), per-hit integrity verdicts (attest), and resource_links to each hit
mem_fetch - deterministic listing of a kind (no embedding)
mem_edges - typed graph introspection
mem_profile - what the memory knows about a query: recall plus its graph neighborhood
mem_summarize - per-kind digest of a region
mem_verify - re-authenticate atoms off disk: per-atom integrity verdict (authentic / tampered / key_erased / missing / plaintext_unattested)
mem_remember / mem_remember_batch - store atoms with payload, importance, TTL, immutability
mem_update - replace a stored atom's payload in place (preserves id, edges, and embedding)
mem_link - connect atoms with a typed edge
mem_evolve - recompute an atom's neighbor links and score
mem_evict - selective forgetting by policy (cryptographic erasure on encrypted regions)
mem_forget - forget atoms by id and return a verifiable erasure receipt (cryptographic erasure on encrypted regions; skips immutable atoms unless forced)

The citadeldb-mcp binary reads the passphrase from CITADEL_KEY and serves one region (encrypted by default); only protocol messages go to stdout, diagnostics to stderr.

Recall is keyword-only (a mock embedder) until you opt into a real semantic model. The (CPU) Candle embedder is compiled into the default build, but models are fetched only on explicit request, never automatically:

citadeldb-mcp pull bge-large                       # one-time download to ~/.citadel/models
citadeldb-mcp --db memory.cdl --embedder bge-large

Pull names: bge-small, bge-base, bge-large, minilm, e5-large. Or point --model-dir at a local model directory for a fully offline setup, and build with --features cuda-embed to run the model on an NVIDIA GPU.

For better recall ordering, add a cross-encoder reranker (off by default, also explicit):

citadeldb-mcp pull ms-marco-minilm
citadeldb-mcp --db memory.cdl --embedder bge-large --reranker ms-marco-minilm

This crate is part of the Citadel workspace.

License

MIT OR Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

citadeldb_mcp-1.12.0.tar.gz (1.0 MB view details)

Uploaded Jul 4, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

citadeldb_mcp-1.12.0-py3-none-win_amd64.whl (7.8 MB view details)

Uploaded Jul 4, 2026 Python 3Windows x86-64

citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (7.5 MB view details)

Uploaded Jul 4, 2026 Python 3manylinux: glibc 2.17+ x86-64

citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (7.0 MB view details)

Uploaded Jul 4, 2026 Python 3manylinux: glibc 2.17+ ARM64

citadeldb_mcp-1.12.0-py3-none-macosx_11_0_arm64.whl (6.7 MB view details)

Uploaded Jul 4, 2026 Python 3macOS 11.0+ ARM64

citadeldb_mcp-1.12.0-py3-none-macosx_10_12_x86_64.whl (7.3 MB view details)

Uploaded Jul 4, 2026 Python 3macOS 10.12+ x86-64

File details

Details for the file citadeldb_mcp-1.12.0.tar.gz.

File metadata

Download URL: citadeldb_mcp-1.12.0.tar.gz
Upload date: Jul 4, 2026
Size: 1.0 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for citadeldb_mcp-1.12.0.tar.gz
Algorithm	Hash digest
SHA256	`45477caf7a836d9e071001b85470cc0fa04ef85e7936a96ca0e808b0f760716f`
MD5	`080b0eb4f935b04082c98540d1d0a760`
BLAKE2b-256	`bac67999ba13ff7a8b94c232d9942f32f7febb019f235dee715ef710f4c2045e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for citadeldb_mcp-1.12.0.tar.gz:

Publisher: release-mcp.yml on yp3y5akh0v/citadel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: citadeldb_mcp-1.12.0.tar.gz
- Subject digest: 45477caf7a836d9e071001b85470cc0fa04ef85e7936a96ca0e808b0f760716f
- Sigstore transparency entry: 2071533579
- Sigstore integration time: Jul 4, 2026
Source repository:
- Permalink: yp3y5akh0v/citadel@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Branch / Tag: refs/tags/v1.12.0
- Owner: https://github.com/yp3y5akh0v
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-mcp.yml@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Trigger Event: push

File details

Details for the file citadeldb_mcp-1.12.0-py3-none-win_amd64.whl.

File metadata

Download URL: citadeldb_mcp-1.12.0-py3-none-win_amd64.whl
Upload date: Jul 4, 2026
Size: 7.8 MB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for citadeldb_mcp-1.12.0-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`a955839a97143be5a01d3f759f7e1a97fc17574f911c5acbb8b63780bebd71b7`
MD5	`a01aee9496e8e6877b1b017c16ecdf01`
BLAKE2b-256	`59aad0c598aa44bd8e753a9475a0e69f34f0e3f7b25182282ade7deb21693d97`

See more details on using hashes here.

Provenance

The following attestation bundles were made for citadeldb_mcp-1.12.0-py3-none-win_amd64.whl:

Publisher: release-mcp.yml on yp3y5akh0v/citadel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: citadeldb_mcp-1.12.0-py3-none-win_amd64.whl
- Subject digest: a955839a97143be5a01d3f759f7e1a97fc17574f911c5acbb8b63780bebd71b7
- Sigstore transparency entry: 2071533609
- Sigstore integration time: Jul 4, 2026
Source repository:
- Permalink: yp3y5akh0v/citadel@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Branch / Tag: refs/tags/v1.12.0
- Owner: https://github.com/yp3y5akh0v
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-mcp.yml@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Trigger Event: push

File details

Details for the file citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Jul 4, 2026
Size: 7.5 MB
Tags: Python 3, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`1945b494dd6e55aaaca495fded15a7da1549fc23b5d99456829a2cd448f6396f`
MD5	`31fec32a299918f829f22d097ab82b34`
BLAKE2b-256	`239593c9ca390ccf9bec4eeb2714db4d6ab034acd976d7d6e9ef9334e38977ff`

See more details on using hashes here.

Provenance

The following attestation bundles were made for citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release-mcp.yml on yp3y5akh0v/citadel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: 1945b494dd6e55aaaca495fded15a7da1549fc23b5d99456829a2cd448f6396f
- Sigstore transparency entry: 2071533651
- Sigstore integration time: Jul 4, 2026
Source repository:
- Permalink: yp3y5akh0v/citadel@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Branch / Tag: refs/tags/v1.12.0
- Owner: https://github.com/yp3y5akh0v
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-mcp.yml@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Trigger Event: push

File details

Details for the file citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Jul 4, 2026
Size: 7.0 MB
Tags: Python 3, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`c6bf89ade896d59c1bb1e6cbef7cc6da41c5094c8e7af9a256b396951b82c79d`
MD5	`8c4353780f3bf723282662b708ce2c9b`
BLAKE2b-256	`56bde4bbebab909093878c26f88ecf4a770f2bd300a93fa9bdb278e8a6cf7c2c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release-mcp.yml on yp3y5akh0v/citadel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: citadeldb_mcp-1.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Subject digest: c6bf89ade896d59c1bb1e6cbef7cc6da41c5094c8e7af9a256b396951b82c79d
- Sigstore transparency entry: 2071533645
- Sigstore integration time: Jul 4, 2026
Source repository:
- Permalink: yp3y5akh0v/citadel@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Branch / Tag: refs/tags/v1.12.0
- Owner: https://github.com/yp3y5akh0v
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-mcp.yml@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Trigger Event: push

File details

Details for the file citadeldb_mcp-1.12.0-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: citadeldb_mcp-1.12.0-py3-none-macosx_11_0_arm64.whl
Upload date: Jul 4, 2026
Size: 6.7 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for citadeldb_mcp-1.12.0-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`1a3189d1a41c8568aa3aff2f3178be26ac11c952785938d7cc10a16e65b8ccc0`
MD5	`3cfa654fb059e91e81208f38860268c3`
BLAKE2b-256	`eb6e36fbe73ac7f074d166d9c7344d38534b45b1e8aa60b90d433ee9219e4f91`

See more details on using hashes here.

Provenance

The following attestation bundles were made for citadeldb_mcp-1.12.0-py3-none-macosx_11_0_arm64.whl:

Publisher: release-mcp.yml on yp3y5akh0v/citadel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: citadeldb_mcp-1.12.0-py3-none-macosx_11_0_arm64.whl
- Subject digest: 1a3189d1a41c8568aa3aff2f3178be26ac11c952785938d7cc10a16e65b8ccc0
- Sigstore transparency entry: 2071533595
- Sigstore integration time: Jul 4, 2026
Source repository:
- Permalink: yp3y5akh0v/citadel@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Branch / Tag: refs/tags/v1.12.0
- Owner: https://github.com/yp3y5akh0v
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-mcp.yml@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Trigger Event: push

File details

Details for the file citadeldb_mcp-1.12.0-py3-none-macosx_10_12_x86_64.whl.

File metadata

Download URL: citadeldb_mcp-1.12.0-py3-none-macosx_10_12_x86_64.whl
Upload date: Jul 4, 2026
Size: 7.3 MB
Tags: Python 3, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for citadeldb_mcp-1.12.0-py3-none-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`3bb833f23872fe5f20ed6d112c2edec80c085290ac5701af165fbad8a0490413`
MD5	`a46d03943fead3d2cacf73b38445ecae`
BLAKE2b-256	`0d78ee5aeed818a3e2a0d98bdf4da1b1ae1389a1a17afef4448ea71a0fc40a40`

See more details on using hashes here.

Provenance

The following attestation bundles were made for citadeldb_mcp-1.12.0-py3-none-macosx_10_12_x86_64.whl:

Publisher: release-mcp.yml on yp3y5akh0v/citadel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: citadeldb_mcp-1.12.0-py3-none-macosx_10_12_x86_64.whl
- Subject digest: 3bb833f23872fe5f20ed6d112c2edec80c085290ac5701af165fbad8a0490413
- Sigstore transparency entry: 2071533626
- Sigstore integration time: Jul 4, 2026
Source repository:
- Permalink: yp3y5akh0v/citadel@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Branch / Tag: refs/tags/v1.12.0
- Owner: https://github.com/yp3y5akh0v
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-mcp.yml@24306eb4f1dea0ce6f8dede53e74297a934c8b3f
- Trigger Event: push

Release history Release notifications | RSS feed

1.15.0

Aug 10, 2026

1.14.0

Aug 7, 2026

1.13.0

Jul 9, 2026

This release

1.12.0

Jul 4, 2026

1.11.0

Jul 3, 2026

citadeldb-mcp 1.12.0

citadeldb-mcp

Install

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed