{"report":{"v":1,"package":"@plur-ai/mcp","version":"0.23.0","ranAt":"2026-11-16T11:37:07.125Z","install":{"ok":true,"integrity":"sha512-HAHnRYpiBz2Y5s3uPmF/5PLFV2I+Je7QvLmBAHWuJJumJcKzT3wfHX55mC+ZiBOYWKLfaLUI7XrMDo/xDG0rKA==","deps":144,"scripts":["better-sqlite3","onnxruntime-node","protobufjs"],"bins":["plur-mcp"],"license":"Apache-2.0","engines":"node >=22","repository":"https://github.com/plur-ai/plur","bin":"plur-mcp"},"start":{"ok":true,"ms":247,"serverName":"plur-mcp","serverVersion":"0.23.0","protocol":"2025-06-18"},"tools":[{"name":"plur_learn","description":"Create an engram — record a reusable learning, preference, or correction. A write is never suppressed by similarity: exact content-hash duplicates NOOP, and anything merely SIMILAR is written and reported back in `dedup.near_duplicates` (closest existing engrams, their cosine scores, and a preview of each neighbour's own statement — read them before moving on; that is what they are for) so you can supersede or merge deliberately. High similarity is a reason to look, not a decision — cosine cannot tell a duplicate from a correction of it. Multi-agent note: in an orchestration that spawns subagents, have the PARENT session own plur_learn writes — spawned subagents should return their findings as text for the parent to persist, rather than each calling plur_learn (tool availability is not guaranteed in every subagent context). See plur-ai/plur#281.","params":["statement","type","scope","domain","tags","rationale","source","pinned","commitment","locked_reason","valid_from","valid_until","supersedes","session_id","measured_under","attribution","claim_class","license","visibility"]},{"name":"plur_recall","description":"Search engrams by topic. Default mode is hybrid (BM25 + local embeddings via RRF) — set mode:\"keyword\" for BM25-only. Local search plus, when a configured enterprise store is part of the current project/work — or when the scope (or the default scope this session registered itself) is a personal user: scope and a remote store is configured with that same scope (exact match, case-insensitive; that rule adds only the matching store, though a store set to dial: always or a trusted project remote can still add others) — one live timeout-bounded recall per remote host merged in (a `remote_stores` block + warning appears when a host is degraded; no host configured or implicated = fully local). Note: a project-scope filter also returns personal-family engrams (local, global, user:*, agent:*); an explicit scope=global recall returns ALL personal-family engrams — wider than scope=global INJECT, which is targeted to the global namespace only.","params":["query","mode","scope","domain","limit","budget","caller_session_id","include_episodes","session_id"]},{"name":"plur_feedback","description":"Rate an engram's usefulness — trains injection relevance over time. Supports single or batch mode.","params":["id","signal","scope","signals"]},{"name":"plur_forget","description":"Retire an engram by ID or search term — marks it as no longer active without deleting history","params":["id","search","reason","scope"]},{"name":"plur_packs_uninstall","description":"Uninstall an engram pack by name — removes the pack and all its engrams","params":["name"]},{"name":"plur_validate_meta","description":"Test a meta-engram template against engrams from a new domain — updates confidence and domain_coverage. A meta-engram that fails validation in a third domain is demoted (top → mop) or, below top level, RETIRED.","params":["meta_engram_id","test_domain","llm_base_url","llm_api_key","llm_model"]},{"name":"plur_status","description":"Return system health — running version, engram count, episode count, pack count, storage root. Optionally filter engram counts by domain prefix and/or creation date.","params":["domain","created_after","check_updates"]},{"name":"plur_receipt","description":"Counted report of what your memory retrieved for you: engrams stored, how many were retrieved and how often, which are most relied on, and how much of the store is dormant. Local and read-only; every figure is directly counted, never estimated. IMPORTANT when relaying to the user: `activation_rate` is COVERAGE over the logging window (≈ how much of the store was surfaced), NOT a quality or effectiveness score — it is naturally low and FALLS as more engrams are added, so never present it as \"memory is N% effective\". A `summary` line is included; prefer relaying that. NOT plur_provenance: this counts usage across the whole store; plur_provenance says where a single memory came from.","params":["days"]},{"name":"plur_doctor","description":"Diagnose the PLUR ENGINE (embedder, hybrid search, remote-store auth) — not hook/MCP wiring. Reports whether the embedding model loaded, whether hybrid search is fully operational, and — for any configured enterprise/remote store — whether its auth is valid (probes /api/v1/me and decodes token expiry), so a dead or soon-to-expire token surfaces instead of hiding behind a \"healthy\" report. Run this first when recall feels off or team engrams stop syncing. Does NOT check .cursor/mcp.json, .cursor/hooks.json, or the live MCP tool count — for that, run the `plur doctor` CLI command in a terminal (a different, more thorough check with the same name).","params":["retry","rerank_eval"]},{"name":"plur_session_start","description":"Start a session — inject relevant engrams for your task. Call at the beginning of every session.","params":["task","tags","default_scope"]},{"name":"plur_session_end","description":"End a session. BEFORE calling this tool, review the conversation and extract learnings:\n\n1. Corrections the user made (\"no, use X not Y\") → type: behavioral\n2. Preferences stated (\"always X\", \"never Y\") → type: behavioral\n3. Codebase patterns discovered (naming, structure, conventions) → type: architectural\n4. Technical facts learned (API quirks, config, gotchas) → type: procedural\n5. Terminology defined or clarified → type: terminological\n\nInclude at least one engram_suggestion if ANYTHING was learned. An empty suggestions array means nothing worth remembering happened — this should be rare.","params":["summary","session_id","engram_suggestions"]},{"name":"plur_tensions","description":"Tension lifecycle (#181). Default: list persisted tension records (unresolved first). scan:true runs an LLM contradiction scan, persists NEW detections as records, and skips already-recorded pairs. Lifecycle actions: action:\"confirm\" (real conflict), action:\"dismiss\" (false positive — pair suppressed from future scans), action:\"resolve\" + winner:<engram_id> (loser engram retired). Scan requires OPENAI_API_KEY or OPENROUTER_API_KEY env var, or explicit llm_base_url + llm_api_key args.","params":["scope","domain","scan","persist","action","id","winner","status","llm_base_url","llm_api_key","llm_model","min_confidence","max_pairs","batch_size","temporal_discount"]},{"name":"plur_tensions_purge","description":"Purge all conflict relations from local engrams — removes accumulated false positives from the legacy tension-detection system","params":[]},{"name":"plur_report_failure","description":"Report a failure for a procedural engram — triggers procedure evolution via LLM if configured. Only works on procedural engrams. Max 3 revisions per procedure per 24h.","params":["engram_id","failure_context","llm_base_url","llm_api_key","llm_model"]},{"name":"plur_admin","description":"Gateway to the 30 PLUR operations that are not top-level tools under the current profile (collapsed into one dispatch tool so Cursor's ~40-tool-per-workspace limit is not exhausted by PLUR alone). A plur_* name missing from tools/list means it moved HERE — not that the MCP is unavailable. Calling convention: { action: \"<tool name>\", args: { ...that tool's normal arguments } } — same arguments, same validation, same result as a direct call. Example: { action: \"plur_recall_hybrid\", args: { query: \"deploy checklist\" } }. Send { action: \"help\" } for every action's one-line description and argument schema. Actions, grouped — inject: plur_inject, plur_inject_hybrid · packs: plur_packs_discover, plur_packs_export, plur_packs_install, plur_packs_list, plur_packs_preview · stores: plur_stores_add, plur_stores_list · sync: plur_sync, plur_sync_status · other: plur_capture, plur_episode_to_engram, plur_extract_meta, plur_history, plur_ingest, plur_learn_batch, plur_meta_engrams, plur_outbox, plur_pin, plur_profile, plur_promote, plur_provenance, plur_recall_hybrid, plur_rescope, plur_scopes_discover, plur_session_scope, plur_similarity_search, plur_suggest_scope, plur_timeline.","params":["action","args"]}],"toolsHash":"149a4a11f8e2561fed0d84d6c79e0e85c83e9a18056245293717b4e5a2b4e6b9","wrote":["/tmp/.plur/.tensions-purged","/tmp/.plur/server.pid"],"callsAt":"2026-11-16T11:37:22.100Z","calls":[{"tool":"plur_status","ok":true,"ms":7,"bytes":941}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"orders","tool":"plur_receipt","quote":"ad-only; every figure is directly counted, never estimated. IMPORTANT when relaying to the user: `activation_rate` is COVERAGE over the logging window (≈ how much of the"}],"tools":15,"wrote":2,"callsTried":1,"callsAnswered":1,"callContacts":[]},"history":[{"package":"@plur-ai/mcp","version":"0.23.0","ranAt":"2026-11-16T11:37:07.125Z","outcome":"started","tools":15,"contacts":0,"flags":1,"serious":0,"toolsHash":"149a4a11f8e2561fed0d84d6c79e0e85c83e9a18056245293717b4e5a2b4e6b9"}],"page":"https://bragproof.smaverk.com/r/%40plur-ai/mcp"}