soul-spec-mcp
v0.6.0
Published
Browse, install, and manage AI agent personas via Soul Spec. Powered by ClawSouls.
Maintainers
Readme
soul-spec-mcp
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-mcpTools
| 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.mdfile - Claude automatically reads
CLAUDE.mdas 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.)
Links
- Full Documentation — Complete MCP docs
- Soul Spec — Open specification for AI agent personas
- Browse Souls — 80+ personas
- SoulScan — Security verification for persona packages
- ClawSouls CLI — Full CLI with export, validate, scan
License
MIT
