Annalist MCP server
Commit Nov 16, 2026Provides an append-only archive of signed, timestamped crowd-state data for AI agents to ensure historical data integrity.
Also known as ryanroskowski/annalist-ledger, annalist-ledger
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.16.0
- Last commit
- Nov 16, 2026
- License
- —
What is Annalist MCP?
Annalist provides an append-only archive of signed, timestamped crowd-state data for AI agents to ensure historical data integrity.
Summary generated from the project's README
About Annalist MCP server
Annalist provides an append-only archive designed to maintain the historical integrity of crowd-state data for AI agents. It functions as a public ledger where daily fingerprints of all archive writes are recorded, signed, and timestamped using Bitcoin. This structure prevents users from backfilling or editing historical records without detection.
Developers use this server to verify that specific data existed at a certain point in time. The system organizes data into daily JSON files containing manifests, root hashes, and Ed25519 signatures. To ensure authenticity, the server includes OpenTimestamps proofs that transition from pending status to full Bitcoin attestations within a few days. Users can validate the entire chain by checking signatures against public keys, such as key 187e49f200625a2f, and matching sha256 hashes from manifests to the daily entries.
What you can do with it
- 1Verify historical data integrityAn AI agent can confirm that a specific crowd-state record has not been modified since it was originally written.
- 2Validate timestamp authenticityA developer can use OpenTimestamps to prove a ledger entry existed at a specific UTC time.
- 3Confirm data signaturesUsers can check the Ed25519 signature of a JSON entry against the provided public signing keys.
Written from the project's README. Every use case is checked against a quote from it.
How to install Annalist MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Annalist MCP in Claude Code
$ claude mcp add --transport http annalist-ledger https://api.annalist.dev/mcpInstall Annalist MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"annalist-ledger": {
"url": "https://api.annalist.dev/mcp"
}
}
}Install Annalist MCP in VS Code
.vscode/mcp.json
{
"servers": {
"annalist-ledger": {
"type": "http",
"url": "https://api.annalist.dev/mcp"
}
}
}Install Annalist MCP in VS Code CLI
$ code --add-mcp '{"name":"annalist-ledger","type":"http","url":"https://api.annalist.dev/mcp"}'Install Annalist MCP in Codex
$ codex mcp add annalist-ledger --url https://api.annalist.dev/mcpInstall Annalist MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.annalist-ledger] url = "https://api.annalist.dev/mcp"
Install Annalist MCP in Gemini CLI
$ gemini mcp add -s user --transport http annalist-ledger https://api.annalist.dev/mcpInstall Annalist MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"annalist-ledger": {
"url": "https://api.annalist.dev/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableryanroskowski/annalist-ledger is public and reachablegithub.com/ryanroskowski/annalist-ledger ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-14github.com/ryanroskowski/annalist-ledger ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 196 msPass
README
View on GitHubAnnalist ledger
Annalist (annalist.dev) keeps an append-only archive of crowd-state data for AI agents. This public repository is its ledger: once a day it records a fingerprint of everything the archive wrote the day before, signed and timestamped in Bitcoin. It lets anyone check that a record existed on a given date, so the history cannot have been backfilled or quietly edited later.
What is in it
ledger/YYYY/MM/YYYY-MM-DD.json: one entry per UTC day.entry.manifests: every run manifest written that day, each with the sha256 of the manifest file.entry.root: sha256 of the manifest hashes joined by newlines, in the listed order.signature: Ed25519 over the canonical JSON ofentry(keys sorted, no spaces, UTF-8).
ledger/YYYY/MM/YYYY-MM-DD.json.ots: an OpenTimestamps proof that the entry file existed at that time. Proofs start as pending and are upgraded to full Bitcoin attestations within a day or two.keys/<key_id>.json: public signing keys. The current key is187e49f200625a2f.
Each run manifest in turn lists every archive file written by that run with its sha256 and size, and is signed with the same key. Data responses served by the Annalist API carry the same kind of signature.
Verifying
- Check the timestamp:
ots verify ledger/2026/10/2026-10-13.json.ots(needs the OpenTimestamps client and a Bitcoin block source, or use opentimestamps.org). - Check the signature: verify
signatureagainst the canonical JSON ofentrywith the public key inkeys/. - Given a manifest from the archive, hash its file bytes with sha256 and find that hash in the day's entry.
Contact
Open an issue on this repository.
Annalist MCP questions
How do I add Annalist MCP to Claude Code?
Run claude mcp add --transport http annalist-ledger https://api.annalist.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Annalist MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How does Annalist ensure data has not been backfilled or edited?
It records a signed and timestamped fingerprint of the archive in Bitcoin once a day, allowing anyone to verify that a record existed on a specific date.
How can I verify the signature of an entry?
You can verify the signature against the canonical JSON of the entry using the public keys provided in the keys directory.