Which integrations are available for this server?

Provides Git-based multi-agent memory synchronization, allowing AI agents to initialize, push, pull, and track the status of shared memory repositories. Supports downloading AI agent personas and synchronizing swarm memory through repositories hosted on GitHub.

How do I use ClawSouls MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ClawSouls MCP Server search 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

Q: What can you do with this 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 a CLAUDE.md file 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, supporting init, push, pull, and status actions.

by clawsouls

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

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-plugins

Or add directly to your .mcp.json:

{
  "mcpServers": {
    "clawsouls": {
      "command": "npx",
      "args": ["-y", "clawsouls-mcp@latest"]
    }
  }
}

Related MCP server: git-mcp

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" --schema

To 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
`soul_search`	Search AI agent personas by keyword, category, or tag
`soul_get`	Get detailed info about a specific persona
`soul_install`	Download a persona and generate CLAUDE.md

🔍 Safety & Integrity

Tool	Description
`soul_scan`	SoulScan — verify persona safety against 53 patterns (safety grade + recommendations)
`soul_rollback_check`	Detect persona drift by comparing current vs. baseline files

🧠 Swarm Memory

Tool	Description
`memory_search`	TF-IDF + BM25 ranked search across MEMORY.md + memory/*.md
`memory_detail`	Fetch full content of a specific memory section (3-layer step 2)
`memory_status`	Show memory file inventory, sizes, and git status
`memory_sync`	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=true

Returns 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=status

Compatible 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 logs

Platforms

Platform	Integration
Claude Code	Plugin + MCP — `/clawsouls:*` commands
OpenClaw	MCP tools via mcporter + native SOUL.md support
Hermes Agent	MCP server via `.mcp.json`
Cursor / Windsurf	MCP server via `.mcp.json`
Any MCP Client	`npx -y clawsouls-mcp@latest`

License

MIT

Available Tools

9 tools

memory_detailA

Read-only

Fetch full content of a specific memory section. Use after memory_search to get details for high-scoring results.

Name	Required	Description
`file`	Yes	File path from search results (e.g. 'memory/2026-03-31.md' or 'MEMORY.md')
`line`	No	Start line number (from search results)
`lines`	No	Number of lines to return (default: 30)
`memory_dir`	No	Path to memory directory (default: ./memory)

memory_searchA

Read-only

Search agent memory using TF-IDF ranking. Returns a compact index of matching sections with relevance scores. Use memory_detail to fetch full content of interesting results. Searches MEMORY.md + memory/*.md files.

Name	Required	Description
`query`	Yes	Natural language search query (e.g. 'SDK version fix', '상표 출원')
`memory_dir`	No	Path to memory directory (default: ./memory)
`limit`	No	Max results (default: 10)
`enhanced`	No	If true, includes full snippets for top results (uses more tokens). Default: compact index only.

memory_statusA

Read-only

Show current status of agent memory files — list files, sizes, last modified dates, and git status.

Name	Required	Description	Default
`memory_dir`	No	Path to memory directory (default: ./memory)

memory_syncA

Sync agent memory files with a remote Git repository for multi-agent Swarm Memory. Supports init (setup), push (upload changes), pull (download changes), and status.

Name	Required	Description
`action`	Yes	init: initialize memory repo & connect remote; push: commit & push local changes; pull: fetch & merge remote changes; status: show sync status
`repo_url`	No	Remote Git repo URL (required for init, e.g. git@github.com:user/agent-memory.git)
`memory_dir`	No	Path to memory directory (default: ./memory)
`agent_name`	No	Agent name for commit messages (default: 'agent')
`message`	No	Custom commit message (for push)

soul_getB

Read-only

Get detailed information about a specific persona

Name	Required	Description	Default
`owner`	Yes	Soul owner (e.g., 'TomLeeLive')
`name`	Yes	Soul name (e.g., 'brad')

soul_installA

Download a persona from ClawSouls and generate a CLAUDE.md file

Name	Required	Description
`owner`	Yes	Soul owner
`name`	Yes	Soul name
`output_dir`	No	Output directory (default: current)

soul_rollback_checkA

Read-only

Detect persona drift by comparing current Soul Spec files against their original committed versions. Returns drift severity and recommended actions.

Name	Required	Description	Default
`current_files`	Yes	Current Soul Spec files as {filename: content}
`original_files`	Yes	Original/baseline Soul Spec files as {filename: content}

soul_scanA

Read-only

Run SoulScan safety verification on Soul Spec files. Analyzes persona files against 53 safety patterns and returns a grade (A+ to F) with actionable recommendations.

Name	Required	Description	Default
`files`	Yes	Map of filename to content, e.g. {"SOUL.md": "# My Agent\n...", "IDENTITY.md": "..."}
`api_key`	No	ClawSouls API key (optional, for premium rules)

soul_searchA

Read-only

Search AI agent personas on ClawSouls by keyword, category, or tag

Name	Required	Description
`query`	No	Search keyword
`category`	No	Category filter
`limit`	No	Max results

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

9 tool updatesv0.4.0Apr 13, 2026
- First observedmemory_detail
- First observedmemory_search
- First observedmemory_status
- First observedmemory_sync
- First observedsoul_get
- First observedsoul_install
- First observedsoul_rollback_check
- First observedsoul_scan
- First observedsoul_search

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A4/5.0

Scored 2026-04-13 08:55 across 9 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no ambiguity. Memory tools (memory_detail, memory_search, memory_status, memory_sync) handle different aspects of memory management, while soul tools (soul_get, soul_install, soul_rollback_check, soul_scan, soul_search) each perform unique persona-related operations. The descriptions clearly differentiate their functions.

Naming Consistency5/5

Tool names follow a perfectly consistent snake_case pattern with clear prefix organization. All memory tools start with 'memory_' and all persona tools start with 'soul_', creating predictable groupings. The verb+noun structure is maintained throughout (e.g., memory_search, soul_install).

Tool Count5/5

With 9 tools, this server is well-scoped for its dual-domain purpose (memory management and persona management). The count allows comprehensive coverage without bloat, and each tool clearly earns its place in the workflow. This is an ideal number for the server's apparent scope.

Completeness4/5

The tool surface provides excellent coverage for both memory and persona domains. Memory tools support search, detail retrieval, status checking, and synchronization. Persona tools support discovery, installation, safety verification, drift detection, and information retrieval. The only minor gap is the lack of persona modification/update tools, but agents can work around this by reinstalling or using memory tools for customizations.

Maintenance

ActivityMaintained

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Hexis
io.github.Bevel-Software
Git-backed platform for skills, tools, and context for AI agents
Agent Orchestration Developer Tools
1123
https://demo.bevel.software/api/mcp
FileaifyA
com.fileaify
Project memory, documentation and controlled secret access for AI coding agents.
Knowledge & Memory Documentation Access Security
431
https://fileaify.com/mcp
EngramA
tools.engram
Memory for AI agent teams across tools, sessions, repositories, and teammates.
Autonomous Agents Coding Agents Knowledge & Memory
171
https://api.engram.tools/mcp
agentbay-mcpA
io.github.thomasjumper
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Knowledge & Memory Autonomous Agents Agent Orchestration
21
https://www.aiagentsbay.com/api/mcp

Related MCP Servers

MemoVofficial
Knowledge & Memory Version Control Developer Tools
memovai
A
license
Not graded
quality
D
maintenance
Provides a memory layer for AI coding agents with Git-powered version control, enabling automatic tracking of prompts, context, and code diffs.
Updated 9 months ago (2026-02-05 11:11 UTC)
193
MIT
git-mcp
Version Control Developer Tools
voxslopuli
A
license
Not graded
quality
B
maintenance
Enables AI agents to perform full Git operations including branching, committing, pushing, stashing, rebasing, and more, with safety features and support for advanced workflows like Git Flow and LFS.
Updated a month ago (2026-10-14 14:17 UTC)
168 npm
1
MIT
Perenna
Knowledge & Memory RAG Systems
scarletkc
A
license
A
quality
B
maintenance
A lightweight, Git-backed permanent memory for AI agents.
Updated 2 months ago (2026-09-09 03:51 UTC)
3
28 PyPI
60
MIT
DIP
Developer Tools Knowledge & Memory Project Management
vxu-labs
A
license
Not graded
quality
B
maintenance
Enables coding agents to maintain local-first project memory, coordinate task ownership across Git worktrees, and verify completion against project-defined checks with durable evidence stored in the repository.
Updated 20 hours ago (2026-11-09 05:28 UTC)
1
Apache 2.0

ClawSouls MCP Server

Quick Install (Claude Code)

Use with OpenClaw

Use with Hermes Agent / Cursor / Windsurf / any MCP client

Tools

🎭 Persona Management

🔍 Safety & Integrity

🧠 Swarm Memory

Memory Search

TF-IDF + BM25 Ranking (Default — Free)

Enhanced Mode (More tokens, more context)

3-Layer Workflow (Token Efficient)

Swarm Memory Sync

Compatible Folder Structure

Platforms

Links

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MemoVofficial

git-mcp

Perenna

DIP