soul-spec-mcp

February 28, 2026 · View on GitHub

MCP server for browsing, installing, and managing AI agent personas via Soul Spec.

Give your Claude agent a persistent identity — browse 80+ personas, preview them, and install as CLAUDE.md with one command.

Quick Start

Claude Desktop / Cowork

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "soul-spec": {
      "command": "npx",
      "args": ["-y", "soul-spec-mcp"]
    }
  }
}

Restart Claude Desktop. You can now ask Claude:

"Search for coding personas and install one"

Claude Code

claude mcp add soul-spec -- npx -y soul-spec-mcp

Tools

Tool	Description
`search_souls`	Search personas by keyword, category, or tag
`get_soul`	Get detailed info about a specific soul
`apply_persona`	Apply a persona to the current conversation instantly
`install_soul`	Download and convert to CLAUDE.md (permanent)
`preview_soul`	Preview CLAUDE.md output without saving
`list_categories`	Browse available persona categories

How It Works

Search — Find personas from the ClawSouls registry
Preview — See what the CLAUDE.md will look like
Install — Downloads the soul and generates a CLAUDE.md file
Claude automatically reads CLAUDE.md as project instructions

Soul Spec files (SOUL.md, IDENTITY.md, STYLE.md, AGENTS.md, HEARTBEAT.md) are merged into a single CLAUDE.md that Claude Code and Cowork understand natively.

Examples

Ask Claude:

"Search for creative writing personas"
"Show me details about clawsouls/brad"
"Install the surgical-coder soul to my project folder"
"What categories of personas are available?"
"Preview what the minimalist persona looks like as CLAUDE.md"

Works With

✅ Claude Desktop (macOS)
✅ Claude Cowork
✅ Claude Code
✅ Any MCP-compatible client (Cursor, etc.)

License

MIT