MCP.Market

Soul MCP server

by AntonioTF5·io.github.AntonioTF5/soul-mcp-server·v1.0.0·2 stars
No reviews yet

MCP server for validating and generating SOUL.md agent identity files from Claude Desktop.

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
New

2 stars

Reviews

Write one

Nobody has reviewed Soul yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Soul tools (3)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • generate_soul_template

    Generate a starter SOUL.md file for a given agent name and keywords.

  • score_soul_file

    Return a completeness score (0-100) for a SOUL.md file based on how many optional fields are filled.

  • validate_soul_file

    Validate a SOUL.md file against the schema. Returns pass/fail and field-level errors.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan3 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 163 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Soul compares

Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 65% of 4,460 AI and agents servers
Tools
3
the typical AI and agents server has 6
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
2
more than 65% of 2,711 AI and agents servers

What its tools let an agent do: 2 read · 1 create

Install Soul in Claude Code, Cursor or VS Code

Runs npx -y soul-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add soul-mcp-server -- npx -y soul-mcp-server
Add to Cursor

What the publisher says

From the Soul repository's README, as published. We do not edit it. Read it on GitHub

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 claudedesktopconfig.json (usually at ~/Library/Application Support/Claude/claudedesktopconfig.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

validatesoulfile

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"

generatesoultemplate

Generates a starter .soul.md for a given agent name and keywords.

Parameters:

  • name (string, required) — the agent's name
  • keywords (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"

scoresoulfile

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.

Nothing above is checked by us. What we check is on the safety report.

Soul: common questions

Is Soul MCP server safe?
Mostly: it is graded B (82/100). Read the Soul safety report
How do I install Soul?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Soul need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Soul maintained?
The last commit was 200 days ago (2026-04-18). The latest release is v1.0.0.
What can I use instead of Soul?
Servers from other publishers that do the same job: agent-device MCP server, agent-device MCP server and Basic Memory MCP server.
How does Soul compare with other AI and agents MCP servers?
safety score 82/100 (higher than 65% of 4,460 AI and agents servers); tools 3 (the typical AI and agents server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Soul

Same job from other publishers: the closest match first, then the best rated.

  • agent-device
    Let AI agents inspect, control, and debug real iOS, Android, desktop, and TV apps
    A
  • agent-device
    Open source device layer for AI agents: control mobile, web, TV, and desktop apps over MCP
    A
  • Basic Memory
    Local-first knowledge management with bi-directional LLM sync via Markdown files.
    B
  • Chart
    A Model Context Protocol server for generating charts using AntV.
    B
  • Openflowkit
    Architecture diagrams for your agent: draw on the live OpenFlowKit canvas or edit diagram files.
    A