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
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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