@supergent/mcp-memory-server

MCP server for Supergent Memory — read and write organizational knowledge from Claude Code.

Setup

1. Create an Agent

In the Supergent UI, go to Memory > Agents and register a new agent. Copy the API key (shown once).

2. Configure Claude Code

Add to your .mcp.json (project or global):

{
  "mcpServers": {
    "supergent-memory": {
      "command": "npx",
      "args": ["@supergent/mcp-memory-server"],
      "env": {
        "SUPERGENT_API_KEY": "mem-...",
        "SUPERGENT_URL": "https://gregarious-buffalo-820.convex.site"
      }
    }
  }
}

3. Restart Claude Code

The 8 Memory tools will appear automatically.

Tools

| Tool | Description | |---|---| | memory_search | Search organizational memory for relevant knowledge | | memory_get | Get full details of a memory node by ID | | memory_create | Record organizational knowledge (decision, insight, policy, etc.) | | memory_update | Update a node's content, status, or tags | | memory_link | Create a typed edge between two nodes | | memory_provenance | Get the full provenance chain — "How We Got Here" | | memory_tags | List accessible tags and your read/write permissions | | memory_schema | Get the ontology: kinds, edges, status machines |

Node Kinds

• decision — A choice that was made
• insight — A lesson learned or pattern discovered
• commitment — An obligation or promise
• policy — A standing rule or guideline
• question — An open question needing resolution
• discussion — An ongoing conversation
• situation — A current state or context
• artifact — A reference to an external resource

Environment Variables

| Variable | Required | Description | |---|---|---| | SUPERGENT_API_KEY | Yes | Agent API key (mem-...) | | SUPERGENT_URL | Yes | Convex site URL |

Development

bun install
bun run build