ClawSouls MCP Server
The ClawSouls MCP Server provides 9 tools across three capability areas for AI agent persona management, safety verification, and multi-agent memory synchronization.
π Persona Management
soul_search: Search AI agent personas by keyword, category, or tag.soul_get: Retrieve detailed information about a specific persona by owner and name.soul_install: Download a persona and generate aCLAUDE.mdfile in a specified output directory.
π Safety & Integrity
soul_scan: Analyze persona files against 53 safety patterns to produce a safety grade (A+ to F) with actionable recommendations.soul_rollback_check: Detect persona drift by comparing current Soul Spec files to their original committed baseline, returning drift severity and recommended actions.
π§ Swarm Memory
memory_search: Search agent memory files (MEMORY.md+memory/*.md) using TF-IDF + BM25 ranking, returning scored results or enhanced snippets.memory_detail: Fetch the full content of a specific memory section by file path and line number for token-efficient retrieval.memory_status: View the inventory of memory files including sizes, last modified dates, and git status.memory_sync: Sync agent memory with a remote Git repository for multi-agent collaboration, supportinginit,push,pull, andstatusactions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ClawSouls MCP Serversearch my memory for recent project decisions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ClawSouls MCP Server
AI agent persona management, safety verification, and memory tools via Model Context Protocol.
9 tools for Claude Code, OpenClaw, and any MCP-compatible client.
Quick Install (Claude Code)
# Install the ClawSouls plugin (includes MCP server)
/plugin marketplace add https://github.com/clawsouls/clawsouls-claude-code-plugin
/plugin install clawsouls
/reload-pluginsOr add directly to your .mcp.json:
{
"mcpServers": {
"clawsouls": {
"command": "npx",
"args": ["-y", "clawsouls-mcp@latest"]
}
}
}Related MCP server: Mnehmos Synch
Use with OpenClaw
OpenClaw consumes MCP servers through mcporter. Call ClawSouls tools ad-hoc over stdio:
mcporter call --stdio "npx -y clawsouls-mcp@latest" soul_search query="chief of staff"
mcporter list --stdio "npx -y clawsouls-mcp@latest" --schemaTo persist it, add the .mcp.json block below to a file and import it:
mcporter config import ./.mcp.json(See mcporter.dev for full config options.)
Use with Hermes Agent / Cursor / Windsurf / any MCP client
Same stdio command via an .mcp.json-style config:
{
"mcpServers": {
"clawsouls": {
"command": "npx",
"args": ["-y", "clawsouls-mcp@latest"]
}
}
}Tools
π Persona Management
Tool | Description |
| Search AI agent personas by keyword, category, or tag |
| Get detailed info about a specific persona |
| Download a persona and generate CLAUDE.md |
π Safety & Integrity
Tool | Description |
| SoulScan β verify persona safety against 53 patterns (safety grade + recommendations) |
| Detect persona drift by comparing current vs. baseline files |
π§ Swarm Memory
Tool | Description |
| TF-IDF + BM25 ranked search across MEMORY.md + memory/*.md |
| Fetch full content of a specific memory section (3-layer step 2) |
| Show memory file inventory, sizes, and git status |
| Git-based multi-agent memory sync (init/push/pull/status) |
Memory Search
TF-IDF + BM25 Ranking (Default β Free)
memory_search query="SDK version fix"Returns a compact index (~50 tokens per result) ranked by relevance:
| # | Location | Section | Score |
|---|-----------------------|------------------|-------|
| 1 | memory/2026-03-31.md:5 | SDK λ²μ λ¬Έμ ν΄κ²° | 2.41 |
| 2 | MEMORY.md:42 | Troubleshooting | 1.87 |Enhanced Mode (More tokens, more context)
memory_search query="SDK version fix" enhanced=trueReturns full snippets with score visualization for top results.
3-Layer Workflow (Token Efficient)
Step 1: memory_search query="bug fix" β compact index with scores
Step 2: memory_detail file="memory/2026-03-31.md" line=5 β full section
Step 3: (optional) memory_search enhanced=true β deep dive~10x token savings compared to loading all memory files.
Swarm Memory Sync
Share memory across multiple agents via Git:
# Initialize (one time)
memory_sync action=init repo_url=git@github.com:user/agent-memory.git
# Push local changes
memory_sync action=push agent_name=brad
# Pull from other agents
memory_sync action=pull
# Check sync status
memory_sync action=statusCompatible Folder Structure
Works with OpenClaw's memory layout:
MEMORY.md # Long-term curated memory
memory/
topic-*.md # Project-specific status/decisions/history
YYYY-MM-DD.md # Daily logsPlatforms
Platform | Integration |
Claude Code | Plugin + MCP β |
OpenClaw | MCP tools via mcporter + native SOUL.md support |
Hermes Agent | MCP server via |
Cursor / Windsurf | MCP server via |
Any MCP Client |
|
Links
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/clawsouls/clawsouls-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server