supermemory-agent 0.2.3__tar.gz → 0.2.4__tar.gz

{supermemory_agent-0.2.3 → supermemory_agent-0.2.4}/.github/workflows/publish.yml

@@ -1,4 +1,4 @@
-name: Publish PyPI and MCP Registry
+name: Publish Release
 
 on:
   release:
@@ -6,11 +6,11 @@ on:
   workflow_dispatch:
 
 permissions:
-  contents: read
+  contents: write
   id-token: write
 
 jobs:
-  publish-pypi:
+  build-and-publish:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -19,12 +19,27 @@ jobs:
         with:
           python-version: "3.11"
 
+      - name: Sync version from release tag
+        if: github.event_name == 'release'
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          sed -i "s/^version = \".*\"/version = \"$VERSION\"/" pyproject.toml
+          jq --arg v "$VERSION" '.version = $v | .packages[0].version = $v' server.json > server.tmp.json
+          mv server.tmp.json server.json
+          echo "Building supermemory-agent $VERSION"
+
       - name: Install build tools
-        run: pip install build twine
+        run: pip install build
 
       - name: Build package
         run: python -m build
 
+      - name: Upload release assets
+        if: github.event_name == 'release'
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
@@ -32,7 +47,7 @@ jobs:
           skip-existing: true
 
   publish-mcp-registry:
-    needs: publish-pypi
+    needs: build-and-publish
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

{supermemory_agent-0.2.3 → supermemory_agent-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supermemory-agent
-Version: 0.2.3
+Version: 0.2.4
 Summary: SuperMemory: MCP-first learning memory layer for Claude, Cursor, and agent workflows
 Project-URL: Homepage, https://github.com/YashvantHange/SuperMemory
 Project-URL: Repository, https://github.com/YashvantHange/SuperMemory
@@ -42,6 +42,10 @@ Description-Content-Type: text/markdown
 
 MCP-first learning memory layer for Claude, Cursor, and agent workflows. Captures distilled lessons from failures and corrections (not full transcripts), validates before storage, and improves agents over time through a closed-loop cycle.
 
+**Monorepo:** MCP server, agent skills (`skills/supermemory-agent-learning/SKILL.md`), REST API, Python SDK, and tests all live in [this repository](https://github.com/YashvantHange/SuperMemory). The PyPI package ships the MCP server and bundled skills together.
+
+**Latest release:** [v0.2.4](https://github.com/YashvantHange/SuperMemory/releases/tag/v0.2.4) — each [GitHub Release](https://github.com/YashvantHange/SuperMemory/releases) includes wheel + sdist package assets.
+
 ## Install from PyPI (recommended for Claude / Cursor users)
 
 ```bash
@@ -55,6 +59,17 @@ Or with [uv](https://docs.astral.sh/uv/):
 uvx supermemory-agent --storage .supermemory --transport stdio
 ```
 
+After install, bundled agent skills are under `site-packages/skills/supermemory-agent-learning/` (copy to `.cursor/skills/` or `~/.cursor/skills/` as needed).
+
+## Install from GitHub Release
+
+Download the wheel from [Releases](https://github.com/YashvantHange/SuperMemory/releases) (each release ships `supermemory_agent-{version}-py3-none-any.whl`):
+
+```bash
+pip install https://github.com/YashvantHange/SuperMemory/releases/download/v0.2.4/supermemory_agent-0.2.4-py3-none-any.whl
+supermemory-agent --storage .supermemory --transport stdio
+```
+
 ## Install from source (developers)
 
 ```bash
@@ -120,6 +135,7 @@ Restart Claude Desktop after editing the config.
 | **Cursor** | `.cursor/skills/supermemory-agent-learning/` | `~/.cursor/skills/supermemory-agent-learning/` |
 | **Claude Code** | `.claude/skills/supermemory-agent-learning/` | `~/.claude/skills/supermemory-agent-learning/` |
 | **Canonical source** | `skills/supermemory-agent-learning/` | edit here, then run `python scripts/sync_skills.py` |
+| **PyPI install** | `site-packages/skills/supermemory-agent-learning/` | bundled with `pip install supermemory-agent` |
 
 Mention **SuperMemory**, **agent learning**, or **MCP memory** in chat to load the skill.
 
@@ -165,6 +181,17 @@ python -m pytest tests/test_core.py -v         # GitHub-compatible closed loop
 
 MIT — see [LICENSE](LICENSE)
 
+## Releases
+
+Every version is published to [GitHub Releases](https://github.com/YashvantHange/SuperMemory/releases) with **wheel + sdist** attached, then synced to PyPI and the MCP Registry via CI.
+
+```bash
+# Maintainer: after bumping pyproject.toml + server.json
+python scripts/release.py --title "v0.2.4 — short summary of changes"
+```
+
+See [docs/RELEASES.md](docs/RELEASES.md) for the full release checklist.
+
 ## Publish / list in directories
 
 See [docs/PUBLISHING.md](docs/PUBLISHING.md) for MCP Registry, Cursor Directory, and Claude Connectors Directory submission steps.

supermemory_agent-0.2.4/PRIVACY.md

@@ -0,0 +1,38 @@
+# SuperMemory Privacy Policy
+
+**Last updated:** June 13, 2026  
+**Contact:** yashvanthange420@gmail.com
+
+## Overview
+
+SuperMemory is a local-first MCP server. All learning data is stored on the user's machine in a `.supermemory/` directory. We do not operate a cloud backend for this product.
+
+## Data Collection
+
+- SuperMemory stores only data explicitly sent by the user or their AI agent through MCP tools (lessons, policies, skills, event summaries).
+- We do not collect telemetry, analytics, or personal information by default.
+- No data is transmitted to SuperMemory developers unless you voluntarily contact us for support.
+
+## Data Storage
+
+- Data is stored locally in the directory configured via `--storage` or `SUPERMEMORY_STORAGE_PATH` (default: `.supermemory/`).
+- Users control retention by deleting their local storage directory.
+
+## Third-Party Sharing
+
+- SuperMemory does not share user data with third parties.
+- No third-party AI models are called by the server.
+
+## Security
+
+- Local file storage only; no remote authentication required.
+- Optional streamable-http transport runs on localhost by default.
+
+## Your Rights
+
+- You may delete all stored data at any time by removing your `.supermemory/` folder.
+- For questions: yashvanthange420@gmail.com or GitHub Issues at https://github.com/YashvantHange/SuperMemory/issues
+
+## Changes
+
+We may update this policy on GitHub. Continued use after changes constitutes acceptance.

{supermemory_agent-0.2.3 → supermemory_agent-0.2.4}/README.md

@@ -4,6 +4,10 @@
 
 MCP-first learning memory layer for Claude, Cursor, and agent workflows. Captures distilled lessons from failures and corrections (not full transcripts), validates before storage, and improves agents over time through a closed-loop cycle.
 
+**Monorepo:** MCP server, agent skills (`skills/supermemory-agent-learning/SKILL.md`), REST API, Python SDK, and tests all live in [this repository](https://github.com/YashvantHange/SuperMemory). The PyPI package ships the MCP server and bundled skills together.
+
+**Latest release:** [v0.2.4](https://github.com/YashvantHange/SuperMemory/releases/tag/v0.2.4) — each [GitHub Release](https://github.com/YashvantHange/SuperMemory/releases) includes wheel + sdist package assets.
+
 ## Install from PyPI (recommended for Claude / Cursor users)
 
 ```bash
@@ -17,6 +21,17 @@ Or with [uv](https://docs.astral.sh/uv/):
 uvx supermemory-agent --storage .supermemory --transport stdio
 ```
 
+After install, bundled agent skills are under `site-packages/skills/supermemory-agent-learning/` (copy to `.cursor/skills/` or `~/.cursor/skills/` as needed).
+
+## Install from GitHub Release
+
+Download the wheel from [Releases](https://github.com/YashvantHange/SuperMemory/releases) (each release ships `supermemory_agent-{version}-py3-none-any.whl`):
+
+```bash
+pip install https://github.com/YashvantHange/SuperMemory/releases/download/v0.2.4/supermemory_agent-0.2.4-py3-none-any.whl
+supermemory-agent --storage .supermemory --transport stdio
+```
+
 ## Install from source (developers)
 
 ```bash
@@ -82,6 +97,7 @@ Restart Claude Desktop after editing the config.
 | **Cursor** | `.cursor/skills/supermemory-agent-learning/` | `~/.cursor/skills/supermemory-agent-learning/` |
 | **Claude Code** | `.claude/skills/supermemory-agent-learning/` | `~/.claude/skills/supermemory-agent-learning/` |
 | **Canonical source** | `skills/supermemory-agent-learning/` | edit here, then run `python scripts/sync_skills.py` |
+| **PyPI install** | `site-packages/skills/supermemory-agent-learning/` | bundled with `pip install supermemory-agent` |
 
 Mention **SuperMemory**, **agent learning**, or **MCP memory** in chat to load the skill.
 
@@ -127,6 +143,17 @@ python -m pytest tests/test_core.py -v         # GitHub-compatible closed loop
 
 MIT — see [LICENSE](LICENSE)
 
+## Releases
+
+Every version is published to [GitHub Releases](https://github.com/YashvantHange/SuperMemory/releases) with **wheel + sdist** attached, then synced to PyPI and the MCP Registry via CI.
+
+```bash
+# Maintainer: after bumping pyproject.toml + server.json
+python scripts/release.py --title "v0.2.4 — short summary of changes"
+```
+
+See [docs/RELEASES.md](docs/RELEASES.md) for the full release checklist.
+
 ## Publish / list in directories
 
 See [docs/PUBLISHING.md](docs/PUBLISHING.md) for MCP Registry, Cursor Directory, and Claude Connectors Directory submission steps.

{supermemory_agent-0.2.3 → supermemory_agent-0.2.4}/docs/PUBLISHING.md

@@ -9,7 +9,7 @@ This guide covers listing SuperMemory so **any Claude or Cursor user** can disco
 | `server.json` | Official [MCP Registry](https://registry.modelcontextprotocol.io) metadata |
 | `.mcp.json` | Cursor Directory auto-detection ([Open Plugins](https://open-plugins.com)) |
 | `examples/claude_desktop_config.json` | Claude Desktop MCP config |
-| `.github/workflows/publish.yml` | PyPI + MCP Registry on GitHub Release |
+| `.github/workflows/publish.yml` | Build wheel/sdist, attach to GitHub Release, PyPI + MCP Registry |
 
 README includes the PyPI ownership marker:
 
@@ -39,14 +39,28 @@ README includes the PyPI ownership marker:
 
 ### Publish (automated — recommended)
 
-1. Create a GitHub Release (tag e.g. `v0.2.0`).
-2. The `Publish PyPI and MCP Registry` workflow runs automatically.
-3. Verify:
+1. Bump `version` in `pyproject.toml` and `server.json`, commit, and push to `main`.
+2. Create a [GitHub Release](https://github.com/YashvantHange/SuperMemory/releases/new) with tag `vX.Y.Z` (must match version).
+3. The **Publish Release** workflow runs automatically:
+   - Builds `supermemory_agent-X.Y.Z-py3-none-any.whl` and `.tar.gz`
+   - Uploads both as release assets
+   - Publishes to PyPI
+   - Publishes to MCP Registry
+4. Verify:
 
    ```bash
    curl "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.YashvantHange/supermemory"
+   pip index versions supermemory-agent
    ```
 
+Or use the helper:
+
+```bash
+python scripts/release.py --title "v0.2.4 — short summary"
+```
+
+See [docs/RELEASES.md](RELEASES.md) for the full checklist.
+
 ### Publish (manual)
 
 ```bash
@@ -160,7 +174,8 @@ cp -r skills/supermemory-agent-learning ~/.claude/skills/supermemory-agent-learn
 
 ## Checklist
 
-- [ ] GitHub Release `v0.2.0` with `PYPI_API_TOKEN` secret set
+- [ ] GitHub Release `v0.2.4` with wheel + sdist assets (see [RELEASES.md](RELEASES.md))
+- [ ] `PYPI_API_TOKEN` secret set for CI
 - [ ] MCP Registry shows `io.github.YashvantHange/supermemory`
 - [ ] Submit to [cursor.directory](https://cursor.directory/plugins/new)
 - [ ] Submit to [Claude Connectors Directory](https://claude.com/docs/connectors/building/submission)

supermemory_agent-0.2.4/docs/RELEASES.md

@@ -0,0 +1,75 @@
+# GitHub Releases
+
+Every SuperMemory version is published as a [GitHub Release](https://github.com/YashvantHange/SuperMemory/releases) with **installable package assets** attached:
+
+| Asset | Purpose |
+|-------|---------|
+| `supermemory_agent-{version}-py3-none-any.whl` | Recommended — `pip install` from file |
+| `supermemory_agent-{version}.tar.gz` | Source distribution |
+
+Creating a release also triggers CI to publish the same build to **PyPI** and the **MCP Registry**.
+
+## Release checklist
+
+1. Bump version in `pyproject.toml` and `server.json` (keep them in sync).
+2. Commit changes with a clear message.
+3. Push to `main`.
+4. Create a GitHub Release (tag must match version, e.g. `v0.2.4`).
+
+### Option A — GitHub UI
+
+1. Open [New release](https://github.com/YashvantHange/SuperMemory/releases/new).
+2. Choose tag `vX.Y.Z` (create from `main` if it does not exist).
+3. Title example: `v0.2.4 — Skills bundled + tool safety annotations`
+4. Write release notes (what changed since last tag).
+5. Click **Publish release**.
+
+The `Publish Release` workflow will:
+
+- Build wheel + sdist
+- Attach both files to the release
+- Upload to PyPI (`supermemory-agent`)
+- Publish `server.json` to the MCP Registry
+
+### Option B — CLI helper
+
+```bash
+# After bumping pyproject.toml / server.json and pushing:
+python scripts/release.py --title "v0.2.4 — Skills bundled + tool safety annotations"
+```
+
+Requires [GitHub CLI](https://cli.github.com/) (`gh`) authenticated.
+
+### Option C — Manual assets only (no CI)
+
+```bash
+python -m pip install build
+python -m build -n
+gh release create v0.2.4 dist/supermemory_agent-0.2.4* \
+  --title "v0.2.4 — Skills bundled + tool safety annotations" \
+  --generate-notes
+```
+
+## Install from a release asset
+
+```bash
+pip install https://github.com/YashvantHange/SuperMemory/releases/download/v0.2.4/supermemory_agent-0.2.4-py3-none-any.whl
+```
+
+Or download the `.whl` and install locally:
+
+```bash
+pip install supermemory_agent-0.2.4-py3-none-any.whl
+supermemory-agent --storage .supermemory --transport stdio
+```
+
+## Required GitHub secret
+
+Set `PYPI_API_TOKEN` under **Settings → Secrets and variables → Actions** so releases can publish to PyPI automatically.
+
+## Version tags
+
+| Tag | Highlights |
+|-----|------------|
+| [v0.2.4](https://github.com/YashvantHange/SuperMemory/releases/tag/v0.2.4) | Skills bundled in PyPI wheel; MCP tool safety annotations |
+| [v0.2.0](https://github.com/YashvantHange/SuperMemory/releases/tag/v0.2.0) | First MCP Registry + PyPI publish |

{supermemory_agent-0.2.3 → supermemory_agent-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "supermemory-agent"
-version = "0.2.3"
+version = "0.2.4"
 description = "SuperMemory: MCP-first learning memory layer for Claude, Cursor, and agent workflows"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -56,6 +56,10 @@ packages = [
 [tool.hatch.build.targets.wheel.force-include]
 "src/supermemory_mcp" = "supermemory_mcp"
 "storage" = "storage"
+"skills" = "skills"
+
+[tool.hatch.build.targets.sdist.force-include]
+"skills" = "skills"
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"

supermemory_agent-0.2.4/scripts/release.py

@@ -0,0 +1,68 @@
+#!/usr/bin/env python3
+"""Build packages and create a GitHub release with wheel + sdist assets."""
+
+from __future__ import annotations
+
+import argparse
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+PYPROJECT = ROOT / "pyproject.toml"
+SERVER_JSON = ROOT / "server.json"
+
+
+def read_version() -> str:
+    text = PYPROJECT.read_text(encoding="utf-8")
+    match = re.search(r'^version = "([^"]+)"', text, re.MULTILINE)
+    if not match:
+        raise SystemExit("Could not read version from pyproject.toml")
+    return match.group(1)
+
+
+def run(cmd: list[str], *, check: bool = True) -> subprocess.CompletedProcess[str]:
+    print("+", " ".join(cmd))
+    return subprocess.run(cmd, cwd=ROOT, check=check, text=True)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--title", help="Release title (default: v{version} — SuperMemory release)")
+    parser.add_argument("--notes", help="Release notes file path")
+    parser.add_argument("--notes-text", help="Inline release notes")
+    parser.add_argument("--draft", action="store_true", help="Create a draft release")
+    parser.add_argument("--skip-build", action="store_true", help="Reuse existing dist/ artifacts")
+    args = parser.parse_args()
+
+    version = read_version()
+    tag = f"v{version}"
+    title = args.title or f"v{version} — SuperMemory release"
+
+    if not args.skip_build:
+        run([sys.executable, "-m", "pip", "install", "build"])
+        run([sys.executable, "-m", "build", "-n"])
+
+    dist = ROOT / "dist"
+    assets = sorted(dist.glob(f"supermemory_agent-{version}*"))
+    if not assets:
+        raise SystemExit(f"No build artifacts found in {dist} for version {version}")
+
+    cmd = ["gh", "release", "create", tag, *[str(a) for a in assets], "--title", title]
+    if args.draft:
+        cmd.append("--draft")
+    if args.notes:
+        cmd.extend(["--notes-file", args.notes])
+    elif args.notes_text:
+        cmd.extend(["--notes", args.notes_text])
+    else:
+        cmd.extend(["--generate-notes"])
+
+    run(cmd)
+    print(f"Created {tag} with {len(assets)} package asset(s).")
+    print(f"https://github.com/YashvantHange/SuperMemory/releases/tag/{tag}")
+
+
+if __name__ == "__main__":
+    main()

{supermemory_agent-0.2.3 → supermemory_agent-0.2.4}/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.YashvantHange/supermemory",
   "title": "SuperMemory",
   "description": "MCP-first agent learning: capture failures, validate lessons, retrieve context, improve.",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "websiteUrl": "https://github.com/YashvantHange/SuperMemory",
   "repository": {
     "url": "https://github.com/YashvantHange/SuperMemory",
@@ -14,7 +14,7 @@
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "supermemory-agent",
-      "version": "0.2.3",
+      "version": "0.2.4",
       "runtimeHint": "supermemory-agent",
       "transport": {
         "type": "stdio"

{supermemory_agent-0.2.3 → supermemory_agent-0.2.4}/skills/README.md

@@ -18,6 +18,8 @@ python scripts/sync_skills.py
 
 ## Install
 
+Skills ship in the same repo as the MCP server and are bundled in the `supermemory-agent` PyPI wheel.
+
 ### Cursor (project)
 
 Already included at `.cursor/skills/supermemory-agent-learning/`.  

{supermemory_agent-0.2.3 → supermemory_agent-0.2.4}/src/supermemory_mcp/server.py

@@ -9,6 +9,12 @@ import sys
 from pathlib import Path
 from typing import Any
 
+from mcp.types import ToolAnnotations
+
+_RO = ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+_RW = ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+_DX = ToolAnnotations(readOnlyHint=False, destructiveHint=True)
+
 ROOT = Path(__file__).resolve().parents[2]
 sys.path.insert(0, str(ROOT))
 sys.path.insert(0, str(ROOT / "packages"))
@@ -33,7 +39,7 @@ def build_server(storage_root: str | None = None):
         raw = await handle_tool(name, arguments or {}, data_dir=data_dir)
         return json.loads(raw)
 
-    @mcp.tool(name="record_event")
+    @mcp.tool(name="record_event", annotations=_RW)
     async def record_event(
         event_type: str,
         summary: str,
@@ -65,7 +71,7 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="record_failure")
+    @mcp.tool(name="record_failure", annotations=_RW)
     async def record_failure(
         summary: str,
         workflow: str | None = None,
@@ -95,7 +101,7 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="record_correction")
+    @mcp.tool(name="record_correction", annotations=_RW)
     async def record_correction(
         summary: str,
         workflow: str | None = None,
@@ -125,7 +131,7 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="reflect")
+    @mcp.tool(name="reflect", annotations=_RW)
     async def reflect(
         event_ids: list[str],
         suggestion: str | None = None,
@@ -137,7 +143,7 @@ def build_server(storage_root: str | None = None):
             {"event_ids": event_ids, "suggestion": suggestion, "lesson_text": lesson_text},
         )
 
-    @mcp.tool(name="validate")
+    @mcp.tool(name="validate", annotations=_RW)
     async def validate(
         reflection_id: str | None = None,
         candidate_lesson: str | None = None,
@@ -155,12 +161,12 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="process_promotions")
+    @mcp.tool(name="process_promotions", annotations=_RW)
     async def process_promotions(limit: int = 50) -> dict[str, Any]:
         """Process pending validated lessons and promote passing items."""
         return await _call("process_promotions", {"limit": limit})
 
-    @mcp.tool(name="retrieve")
+    @mcp.tool(name="retrieve", annotations=_RO)
     async def retrieve(
         query: str,
         workflow: str | None = None,
@@ -192,7 +198,7 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="report_outcome")
+    @mcp.tool(name="report_outcome", annotations=_RW)
     async def report_outcome(
         lesson_id: str,
         used: bool,
@@ -214,17 +220,17 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="get_policies")
+    @mcp.tool(name="get_policies", annotations=_RO)
     async def get_policies(namespace: str = "global") -> dict[str, Any]:
         """Return active policies visible to a namespace."""
         return await _call("get_policies", {"namespace": namespace})
 
-    @mcp.tool(name="add_policy")
+    @mcp.tool(name="add_policy", annotations=_RW)
     async def add_policy(rule: str, namespace: str = "global", priority: int = 100) -> dict[str, Any]:
         """Add a local policy rule."""
         return await _call("add_policy", {"rule": rule, "namespace": namespace, "priority": priority})
 
-    @mcp.tool(name="add_skill")
+    @mcp.tool(name="add_skill", annotations=_RW)
     async def add_skill(
         name: str,
         description: str,
@@ -250,7 +256,7 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="search_skills")
+    @mcp.tool(name="search_skills", annotations=_RO)
     async def search_skills(
         query: str,
         workflow: str | None = None,
@@ -263,12 +269,12 @@ def build_server(storage_root: str | None = None):
             {"query": query, "workflow": workflow, "namespace": namespace, "top_k": top_k},
         )
 
-    @mcp.tool(name="get_skill")
+    @mcp.tool(name="get_skill", annotations=_RO)
     async def get_skill(skill_id: str) -> dict[str, Any]:
         """Read a reusable skill by ID."""
         return await _call("get_skill", {"skill_id": skill_id})
 
-    @mcp.tool(name="learn.run.start")
+    @mcp.tool(name="learn.run.start", annotations=_RW)
     async def learn_run_start(
         workflow_id: str,
         step: str | None = None,
@@ -287,7 +293,7 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="learn.run.event")
+    @mcp.tool(name="learn.run.event", annotations=_RW)
     async def learn_run_event(
         run_id: str,
         event_type: str,
@@ -316,7 +322,7 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="learn.run.end")
+    @mcp.tool(name="learn.run.end", annotations=_RW)
     async def learn_run_end(
         run_id: str,
         success: bool,
@@ -327,11 +333,11 @@ def build_server(storage_root: str | None = None):
             {"run_id": run_id, "success": success, "lessons_used": lessons_used or []},
         )
 
-    @mcp.tool(name="learn.store")
+    @mcp.tool(name="learn.store", annotations=_RW)
     async def learn_store(lesson_json: str) -> dict[str, Any]:
         return await _call("learn.store", {"lesson_json": lesson_json})
 
-    @mcp.tool(name="learn.retrieve")
+    @mcp.tool(name="learn.retrieve", annotations=_RO)
     async def learn_retrieve(
         query: str,
         workflow: str | None = None,
@@ -350,7 +356,7 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="learn.reflect")
+    @mcp.tool(name="learn.reflect", annotations=_RW)
     async def learn_reflect(
         event_ids: list[str] | None = None,
         suggestion: str | None = None,
@@ -375,7 +381,7 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="learn.validate")
+    @mcp.tool(name="learn.validate", annotations=_RW)
     async def learn_validate(
         failure: str,
         fix: str,
@@ -392,11 +398,11 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="learn.evaluate")
+    @mcp.tool(name="learn.evaluate", annotations=_RO)
     async def learn_evaluate(run_id: str) -> dict[str, Any]:
         return await _call("learn.evaluate", {"run_id": run_id})
 
-    @mcp.tool(name="learn.feedback")
+    @mcp.tool(name="learn.feedback", annotations=_RW)
     async def learn_feedback(
         rating: str,
         comment: str | None = None,
@@ -407,7 +413,7 @@ def build_server(storage_root: str | None = None):
             {"rating": rating, "comment": comment, "run_id": run_id},
         )
 
-    @mcp.tool(name="learn.improvements")
+    @mcp.tool(name="learn.improvements", annotations=_RO)
     async def learn_improvements(
         workflow_id: str | None = None,
         agent_id: str | None = None,
@@ -417,15 +423,15 @@ def build_server(storage_root: str | None = None):
             {"workflow_id": workflow_id, "agent_id": agent_id},
         )
 
-    @mcp.tool(name="learn.analytics")
+    @mcp.tool(name="learn.analytics", annotations=_RO)
     async def learn_analytics() -> dict[str, Any]:
         return await _call("learn.analytics", {})
 
-    @mcp.tool(name="learn.policies")
+    @mcp.tool(name="learn.policies", annotations=_RO)
     async def learn_policies() -> dict[str, Any]:
         return await _call("learn.policies", {})
 
-    @mcp.tool(name="learn.experiment")
+    @mcp.tool(name="learn.experiment", annotations=_RW)
     async def learn_experiment(
         resource_id: str,
         variant_b: str,
@@ -436,7 +442,7 @@ def build_server(storage_root: str | None = None):
             {"resource_id": resource_id, "variant_b": variant_b, "traffic_split": traffic_split},
         )
 
-    @mcp.tool(name="learn.rollback")
+    @mcp.tool(name="learn.rollback", annotations=_DX)
     async def learn_rollback(
         resource_type: str,
         resource_id: str,
@@ -451,11 +457,11 @@ def build_server(storage_root: str | None = None):
             },
         )
 
-    @mcp.tool(name="learn.skills")
+    @mcp.tool(name="learn.skills", annotations=_RO)
     async def learn_skills(query: str) -> dict[str, Any]:
         return await _call("learn.skills", {"query": query})
 
-    @mcp.tool(name="learn.telemetry")
+    @mcp.tool(name="learn.telemetry", annotations=_RW)
     async def learn_telemetry(
         lesson_id: str,
         run_id: str | None = None,

{supermemory_agent-0.2.3 → supermemory_agent-0.2.4}/tests/test_mcp_server.py

@@ -131,6 +131,34 @@ async def test_mcp_stdio_lists_and_calls_tools(tmp_path):
             assert skills_data["skills"][0]["skill_id"] == skill_data["id"]
 
 
+@pytest.mark.anyio
+async def test_mcp_tools_have_safety_annotations(tmp_path):
+    env = os.environ.copy()
+    env["PYTHONPATH"] = os.pathsep.join([str(ROOT / "src"), str(ROOT / "packages"), str(ROOT)])
+    params = StdioServerParameters(
+        command=sys.executable,
+        args=[
+            "-m",
+            "supermemory_mcp.server",
+            "--storage",
+            str(tmp_path / ".supermemory"),
+            "--transport",
+            "stdio",
+        ],
+        env=env,
+    )
+
+    async with stdio_client(params) as (read, write):
+        async with ClientSession(read, write) as session:
+            await session.initialize()
+            tools = await session.list_tools()
+            assert len(tools.tools) == 29
+            for tool in tools.tools:
+                assert tool.annotations is not None, f"{tool.name} missing annotations"
+                assert tool.annotations.readOnlyHint is not None
+                assert tool.annotations.destructiveHint is not None
+
+
 @pytest.fixture
 def anyio_backend():
     return "asyncio"