Server data from the Official MCP Registry
MCP server for validating and generating SOUL.md agent identity files from Claude Desktop.
About
MCP server for validating and generating SOUL.md agent identity files from Claude Desktop.
Security Report
Valid MCP server (2 strong, 4 medium validity signals). 4 known CVEs in dependencies (0 critical, 2 high severity) Package registry verified. Imported from the Official MCP Registry.
3 files analyzed · 5 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-antoniotf5-soul-mcp-server": {
"args": [
"-y",
"soul-mcp-server"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
soul-mcp-server
MCP server for SOUL.md — validate and generate soul files directly from Claude Desktop or any MCP-compatible client.
Built for Agenturo — the reference SOUL.md implementation. Deploy your soul file as a live agent on your own subdomain.
30-second setup
Add this to your claude_desktop_config.json (usually at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"soul-md-cli": {
"command": "npx",
"args": ["soul-mcp-server"]
}
}
}
Restart Claude Desktop. The three soul tools will appear in your tool list.
Tools
validate_soul_file
Validates a .soul.md file against the SOUL.md schema.
Parameters:
path(string, required) — path to the soul file
Returns: JSON with pass boolean, name, version, and errors array.
Example prompt:
"Validate my soul file at ~/agents/marcus.soul.md"
generate_soul_template
Generates a starter .soul.md for a given agent name and keywords.
Parameters:
name(string, required) — the agent's namekeywords(string[], optional) — domain keywords to seed the template
Returns: A ready-to-edit soul file as a string.
Example prompt:
"Generate a soul template for a climate scientist who specializes in carbon capture"
score_soul_file
Returns a completeness score (0–100) based on how many optional fields are filled.
Parameters:
path(string, required) — path to the soul file
Returns: JSON with score, filled, missing, and total.
Example prompt:
"Score my agent at ~/agents/startup-advisor.soul.md and tell me what's missing"
Spec & examples
Full specification: soul-spec
Curated community soul files: awesome-soul-files
CLI validator (no Claude required): soul-md-cli
MIT License. Created by Anton Agafonov.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption