MCP.Market

SuperMemory MCP server

by YashvantHange·io.github.YashvantHange/supermemory·v0.2.5·2 stars
No reviews yet

MCP-first agent learning: capture failures, validate lessons, retrieve context, improve.

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
New

2 stars31 downloads/wk

Reviews

Write one

Nobody has reviewed SuperMemory yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

SuperMemory tools (29, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • add_policy

    Add a local policy rule.

  • add_skill

    Add a reusable skill/workflow block.

  • get_policies

    Return active policies visible to a namespace.

  • get_skill

    Read a reusable skill by ID.

  • learn.analytics
  • learn.evaluate
  • learn.experiment
  • learn.feedback
  • learn.improvements
  • learn.policies
  • learn.reflect
  • learn.retrieve
  • learn.rollback
  • learn.run.endwrite action
  • learn.run.eventwrite action
  • learn.run.startwrite action
  • learn.skills
  • learn.store
  • learn.telemetry
  • learn.validate
  • process_promotions

    Process pending validated lessons and promote passing items.

  • record_correction

    Record a bounded correction signal.

  • record_event

    Record a bounded significant event. Full transcripts should not be sent here.

  • record_failure

    Record a bounded failure signal.

  • reflectwrite action

    Create a candidate lesson from evidence events.

  • report_outcome

    Report telemetry for a retrieved lesson.

  • retrieve

    Retrieve policy-first, stage-aware lessons.

  • search_skills

    Search reusable skills visible to a namespace.

  • validate

    Validate a lesson candidate and enqueue approved lessons for promotion.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan58 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 105 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How SuperMemory compares

Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 65% of 4,460 AI and agents servers
Tools
29
the typical AI and agents server has 6
Tools that change things
14%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
2
more than 65% of 2,711 AI and agents servers
Downloads a week
31
more than 18% of 1,538 AI and agents servers with a package

What its tools let an agent do: 22 read · 2 create · 1 change · 4 run or deploy

Install SuperMemory in Claude Code, Cursor or VS Code

claude mcp add supermemory -- uvx supermemory-agent
Add to Cursor

What the publisher says

From the SuperMemory repository's README, as published. We do not edit it. Read it on GitHub

SuperMemory

<!-- mcp-name: io.github.YashvantHange/supermemory -->

MCP-first agent learning layer for Claude, Cursor, and custom agent workflows.

SuperMemory captures distilled lessons from failures and corrections — not full conversation transcripts — validates them before storage, and improves agents over time through a closed-loop cycle.

Quick start

pip install supermemory-agent
supermemory-agent --storage .supermemory --transport stdio

Or with uv:

uvx supermemory-agent --storage .supermemory --transport stdio

Latest release: v0.2.4 — wheel + sdist attached on every GitHub Release.

What you get

Everything lives in one repo: MCP server, skills, SDK, REST API, tests, and release packages.

Install

PyPI (recommended)

pip install supermemory-agent

After install, bundled skills are at site-packages/skills/supermemory-agent-learning/. Copy to your editor skills folder if needed.

GitHub Release (offline / pinned version)

Each release ships installable assets:

pip install https://github.com/YashvantHange/SuperMemory/releases/download/v0.2.4/supermemory_agent-0.2.4-py3-none-any.whl

Browse all versions: github.com/YashvantHange/SuperMemory/releases

From source (developers)

git clone https://github.com/YashvantHange/SuperMemory.git
cd SuperMemory
pip install -e ".[dev]"
python -m pytest tests/ -v

Configure MCP

Cursor

Copy examples/cursor.mcp.json to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "supermemory": {
      "command": "supermemory-agent",
      "args": ["--storage", ".supermemory", "--transport", "stdio"]
    }
  }
}

Claude Desktop

Merge examples/claudedesktopconfig.json into:

%APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop after saving.

Run manually

Do not run supermemory-agent alone in a terminal — stdio mode expects JSON-RPC from an MCP client. Pressing Enter in the shell causes a JSON parse error.

# For local HTTP testing only:
supermemory-agent --transport streamable-http

When configured in Cursor or Claude Desktop, the client launches the server automatically over stdio.

Agent skills (Cursor + Claude Code)

After editing skills/, sync copies:

python scripts/sync_skills.py

Mention SuperMemory, agent learning, or MCP memory in chat to load the skill.

Learning loop

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

SuperMemory: common questions

Is SuperMemory MCP server safe?
Mostly: it is graded B (82/100). Read the SuperMemory safety report
How do I install SuperMemory?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does SuperMemory need an API key?
No secret keys are declared. It reads 2 settings from the environment.
Is SuperMemory maintained?
The last commit was 144 days ago (2026-06-13). The latest release is v0.2.5.
What can I use instead of SuperMemory?
Servers from other publishers that do the same job: Basic Memory MCP server, HOL Guard MCP server and Agent-Native Chat MCP server.
How does SuperMemory compare with other AI and agents MCP servers?
safety score 82/100 (higher than 65% of 4,460 AI and agents servers); tools 29 (the typical AI and agents server has 6); tools that change things 14% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to SuperMemory

Same job from other publishers: the closest match first, then the best rated.

  • Basic Memory
    Local-first knowledge management with bi-directional LLM sync via Markdown files.
    B
  • HOL Guard
    Local-first AI agent security evidence and approval workflows through HOL Guard's stdio MCP server.
    A
  • Agent-Native Chat
    Minimal chat-first app with durable threads, actions, and the app-agent loop
    A
  • Agent Recall
    Correction-first agent memory. Precision KPI tracks if agents heed warnings. 5 layers, local-only.
    A