Soulsketch MCP server

GitHub repository · npm: @soulsketch/mcp-server

SoulSketch Protocol 🧬

💖 Support Our Work

If SoulSketch sparks ideas or helps you build, consider supporting us.

Every contribution fuels our ability to learn, experiment, and share more with the community.

Cardano/Midnight Wallet Handle: $johnny5i

🧬 An open protocol for portable AI memory packs

SoulSketch is an open protocol and reference implementation for capturing an AI assistant's memory pack: persona, relationships, technical context, voice, and runtime observations, in a portable, version-controlled format that can be carried across model upgrades, platforms, and machines.

It grew out of an experimental hand-off of one assistant ("Alice", originally on GPT-4.1) to another ("Cassie", on Claude) and has since expanded into a small AI family used day-to-day by the maintainer. SoulSketch is research-grade software: useful, opinionated, and still evolving. See Limitations before relying on it in production.

Modern Ai platforms increasingly include their own memory features. SoulSketch is not trying to replace those features. It exists for the part they do not solve well: user-owned continuity that is portable, inspectable, version-controlled, and able to move across tools, repos, machines, and model providers.

What's in the box

authority, and trust metadata for auditable continuity.

• 🧠 5-Fold Memory Pack: a small, opinionated file layout for identity (persona, relationships, technical domains, stylistic voice, runtime observations).
• 🔄 Model-agnostic: memory packs are plain Markdown + JSONL, not tied to a specific provider.
• 👨‍👩‍👧‍👦 AI Family pattern: documented conventions for running coordinated assistants across multiple machines (Alice, Cassie, Casie, Cara, Penny, Win).
• 🔌 MCP server: @soulsketch/mcp-server exposes validate/fingerprint/diff/read/observe tools to any MCP client (Claude Desktop, Windsurf, Cursor, …) — see docs/MCP_SERVER.md. Also plays well with the standard memory, filesystem, git, and github MCP servers.
• 🔐 Public protocol + private Soul-Sanctum: this repo is the skeleton; users keep their own memories in a private companion repo called their Soul-Sanctum — the one place their assistant's identity lives, owned by them alone. (The maintainer's Soul-Sanctum is PixyPi.)
• 🛠️ TypeScript core + CLI: a @soulsketch/core package and a soulsketch CLI for working with packs and memory.
• 🔎 Fingerprints and trust labels: deterministic hashes plus provenance,

📖 Quick Start

Fastest path: the MCP server (published on npm)

@soulsketch/mcp-server works today in any MCP client (Claude Desktop, Windsurf, Cursor, …). Add it to your client's MCP config:

{
  "soulsketch": {
    "command": "npx",
    "args": ["-y", "@soulsketch/mcp-server"],
    "env": {
      "SOULSKETCH_ALLOWED_ROOTS": "/path/to/your/soul-sanctum"
    }
  }
}

Shortened. The full README is on GitHub.