persistent-memory
PYPI · PERSISTENT-MEMORY-MCP
Agent memory that tracks sources and stops serving what depends on corrected or withdrawn facts.
Available components
Last scanned (15 hours ago)
Scores higher than 60% of PyPI servers
Category Memory and Knowledge
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security50
- Malware scan not yet available for this package.Unverified
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- No production dependencies, so there is no dependency health to assess. View diagnostics → Pass
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to Musyg/persistent-memory). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 3 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability67
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2060 tokens (~206/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management17
- Stability observed for 5 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 11 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (15)
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (1)
These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Malware scan in Supply Chain SecurityMalware scan not yet available for this package.
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Nov 26 −14
- Malware scan: pass → unverified ▼ security
- 20 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 19 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Nov 26 +2
- Schema quality: pass → fail ▼ functional
- Tool coverage: 59% → 100% ▲ functional
- Stability: unverified → 0.03 ▲ functional
- Schema quality: good → excellent functional
- Package version: 0.4.0a3 → 0.4.0a4 functional
- 16 Nov 26 63
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Analysed pypi/persistent-memory-mcp@0.4.0a4
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | pypi |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | Musyg/persistent-memory |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/Musyg/persistent-memory/.github/workflows/release.yml@refs/tags/v0.4.0a4 |
| Rekor log index | 3949497615 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:ea3c4d3d94db26ae8d0b4b972ad24bcfbbf46b4f862bbce1960fcbfe3c002115 |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | Known build tool | setuptools.build_meta |
Background: Why install scripts are a supply-chain risk →
Dependencies 0 packages
| Packages resolved | 0 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
memory_correct Correct an artifact ~293
Replace an artifact's text when the user corrects it, keeping its history. Only applies if expected_version is still its current version; otherwise it is refused with version_conflict, and you search again. Metadata you leave out is kept. Whatever was derived from the old version stops being served and its readers are notified. To remove something entirely, use memory_withdraw.
| Name | Type | Req | Description |
|---|---|---|---|
| aliases | array | – | Short names to find it again. |
| artifact_id | string | yes | The artifact_id returned when it was stored or found by memory_search. |
| confidence | number | – | Declared, not computed. Leave out unless the user gave one. |
| expected_version | string | yes | The version_id of the ref you read. |
| parents | array | – | For a derived artifact: its new parents. Leave out to keep them. |
| preconditions | object | – | Exact conditions a search must supply to see it. Leave out unless the user said it only holds under a condition: a search without these conditions will not return it. |
| text | string | yes | The corrected statement. |
| valid_from | string | – | UTC time it starts to apply, e.g. 2026-01-31T00:00:00Z. Leave out unless the user gave one; by default it applies now. |
| valid_until | string | – | UTC time after which it no longer applies. Leave out unless the user gave one. |
No output schema declared.
No examples provided.
memory_derive Derive from exact parents ~305
Store a summary, conclusion or procedure you built from entries already in memory, linked to the exact versions it came from. Use it instead of memory_remember whenever the text depends on stored entries: if one of them is later corrected or withdrawn, this artifact stops being served and sessions that saw it are notified. Returns artifact_id and ref.
| Name | Type | Req | Description |
|---|---|---|---|
| aliases | array | – | Short names to find it again. |
| artifact_id | string | – | Stable name you choose. Leave out to get one. |
| confidence | number | – | Declared, not computed. Leave out unless the user gave one. |
| kind | string | – | observation for a fact, document for a text, procedure for how to do something, task, feedback, or hypothesis for a guess nobody confirmed. |
| parents | array | yes | The refs it was built from, as returned by memory_search. |
| preconditions | object | – | Exact conditions a search must supply to see it. Leave out unless the user said it only holds under a condition: a search without these conditions will not return it. |
| text | string | yes | The derived statement, self-contained. |
| valid_from | string | – | UTC time it starts to apply, e.g. 2026-01-31T00:00:00Z. Leave out unless the user gave one; by default it applies now. |
| valid_until | string | – | UTC time after which it no longer applies. Leave out unless the user gave one. |
No output schema declared.
No examples provided.
memory_explain Explain an artifact ~127
Explain why an artifact is or is not served: its state, its versions, what it was derived from and what depends on it. Metadata only, never text. Use it when a search leaves out something the user expects, or before a correction. Read-only; unknown_artifact if it does not exist. Give artifact_id or ref.
| Name | Type | Req | Description |
|---|---|---|---|
| artifact_id | string | – | The artifact_id returned when it was stored or found by memory_search. |
| ref | object | – | An exact version: the ref object returned by memory_search, memory_remember or memory_derive, copied unchanged. |
No output schema declared.
No examples provided.
memory_learn Learn a lesson ~309
After a task, store the lesson drawn from it, with the task trace and the feedback it got kept as its provenance. Only the lesson is returned by searches; withdrawing the trace or the feedback stops serving the lesson. For a fact the user states, use memory_remember.
| Name | Type | Req | Description |
|---|---|---|---|
| aliases | array | – | Short names to find it again. |
| confidence | number | – | Declared, not computed. Leave out unless the user gave one. |
| feedback | – | yes | What the user or a check said about the result. |
| kind | string | – | observation for a fact, document for a text, procedure for how to do something, task, feedback, or hypothesis for a guess nobody confirmed. |
| lesson | string | yes | The rule to apply next time, self-contained. |
| lesson_id | string | – | Stable name you choose. Leave out to get one. |
| preconditions | object | – | Exact conditions a search must supply to see it. Leave out unless the user said it only holds under a condition: a search without these conditions will not return it. |
| trace | – | yes | What was done: steps, commands or a summary of them. |
| valid_from | string | – | UTC time it starts to apply, e.g. 2026-01-31T00:00:00Z. Leave out unless the user gave one; by default it applies now. |
| valid_until | string | – | UTC time after which it no longer applies. Leave out unless the user gave one. |
No output schema declared.
No examples provided.
memory_notices Check notices ~75
List the artifacts this session was shown that have since been withdrawn, invalidated or superseded, so you stop relying on them and on what you said from them. Each is reported once. Other tool results already carry new notices as memory_notices; call this when you need to check explicitly, for example before a final answer.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
memory_plan_withdrawal Plan a withdrawal ~70
Preview a withdrawal: list every version that memory_withdraw would stop serving, the artifact and everything derived from it, without changing anything. Use it to show the user the consequences before withdrawing.
| Name | Type | Req | Description |
|---|---|---|---|
| artifact_id | string | yes | The artifact_id returned when it was stored or found by memory_search. |
No output schema declared.
No examples provided.
memory_read Read one version ~107
Re-read one exact version you got from memory_search or a write, for example before relying on it again later in a conversation. Returns its text if it is still valid; otherwise allowed is false and reason and state say why (superseded, withdrawn, expired), with no text. Read-only. To look for something, use memory_search.
| Name | Type | Req | Description |
|---|---|---|---|
| ref | object | yes | An exact version: the ref object returned by memory_search, memory_remember or memory_derive, copied unchanged. |
No output schema declared.
No examples provided.
memory_remember Remember a source ~335
Store a new fact, decision, document or procedure the user stated or confirmed, as a source. Do not use it for your own conclusions (memory_derive), for lessons after a task (memory_learn), or to change something already stored (memory_correct). Returns artifact_id and ref, plus similar when existing entries are worded almost the same. A source_id that already exists is refused with version_conflict, except an identical retry in the same second; to change it, use memory_correct.
| Name | Type | Req | Description |
|---|---|---|---|
| aliases | array | – | Short names to find it again. |
| confidence | number | – | Declared, not computed. Leave out unless the user gave one. |
| kind | string | – | observation for a fact, document for a text, procedure for how to do something, task, feedback, or hypothesis for a guess nobody confirmed. |
| preconditions | object | – | Exact conditions a search must supply to see it. Leave out unless the user said it only holds under a condition: a search without these conditions will not return it. |
| source_id | string | – | Stable name you choose, such as 'db-port', to correct or withdraw it later. Leave out to get one. |
| text | string | yes | Self-contained statement, with its date if known. |
| valid_from | string | – | UTC time it starts to apply, e.g. 2026-01-31T00:00:00Z. Leave out unless the user gave one; by default it applies now. |
| valid_until | string | – | UTC time after which it no longer applies. Leave out unless the user gave one. |
No output schema declared.
No examples provided.
memory_search Search memory ~204
Find stored facts, decisions and procedures by keywords. Use it before answering about anything the user said or decided earlier. Returns only current, valid versions, each with its text, kind, artifact_id and exact ref; withdrawn, superseded and expired versions are left out, and an empty list means nothing valid matches. Read-only. To re-read one version you already hold, use memory_read.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | UTC time to check validity at. Leave out for now. |
| conditions | object | – | Facts about the current situation, matched exactly against stored preconditions. Leave out unless the user describes a situation. |
| kinds | array | – | Only these kinds. Leave out to search all. |
| max_chars | integer | – | Maximum characters of text returned in total, default 2000. |
| query | string | yes | Keywords or a question. |
| top_k | integer | – | Maximum number of results, default 5. Leave out unless you need more. |
No output schema declared.
No examples provided.
memory_withdraw Withdraw an artifact ~136
Stop serving an artifact the user says is wrong, outdated or must be forgotten, together with everything derived from it; sessions that saw them are notified. The text is not physically erased and the history keeps the reason. Run memory_plan_withdrawal first when the user should see what it blocks. To replace a text with a better one, use memory_correct instead.
| Name | Type | Req | Description |
|---|---|---|---|
| artifact_id | string | yes | The artifact_id returned when it was stored or found by memory_search. |
| event_id | string | – | Optional key; repeating a call with the same key changes nothing. |
| reason | string | yes | Why, in the user's words. |
No output schema declared.
No examples provided.
How do I install the persistent-memory MCP server?
persistent-memory runs locally as a PyPI package, launched with uvx persistent-memory-mcp --create. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.
pypi · persistent-memory-mcp
claude mcp add musyg-persistent-memory -- uvx persistent-memory-mcp --create
What is the persistent-memory MCP server?
persistent-memory is an MCP server listed in the public MCP registry as io.github.Musyg/persistent-memory. Agent memory that tracks sources and stops serving what depends on corrected or withdrawn facts. This page covers its PyPI package (persistent-memory-mcp).
Is the persistent-memory MCP server safe to use?
persistent-memory scores 67 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the persistent-memory MCP server expose?
persistent-memory exposes 10 tools: memory_search, memory_read, memory_remember, memory_derive, memory_correct, and 5 more. Their descriptions and schemas cost roughly 1,961 tokens of context every time the server is loaded.
Is the persistent-memory MCP server still maintained?
persistent-memory is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the persistent-memory MCP server under?
persistent-memory declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.
What did VerifyMCP test on the persistent-memory MCP server?
VerifyMCP ran 15 checks on persistent-memory, covering Known CVEs, Install scripts, Dependency health, Source repository and 11 more. One item could not be completed, a gap on our side rather than a finding about persistent-memory: Malware scan. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.