{
  "markdown": "# soul-mcp-server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n\nMCP server for [SOUL.md](https://github.com/AntonioTF5/soul-spec) — validate and generate soul files directly from Claude Desktop or any MCP-compatible client.\n\nBuilt for [Agenturo](https://agenturo.app) — the reference SOUL.md implementation. Deploy your soul file as a live agent on your own subdomain.\n\n---\n\n## 30-second setup\n\nAdd this to your `claude_desktop_config.json` (usually at `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"soul-md-cli\": {\n      \"command\": \"npx\",\n      \"args\": [\"soul-mcp-server\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The three soul tools will appear in your tool list.\n\n---\n\n## Tools\n\n### `validate_soul_file`\n\nValidates a `.soul.md` file against the SOUL.md schema.\n\n**Parameters:**\n- `path` (string, required) — path to the soul file\n\n**Returns:** JSON with `pass` boolean, `name`, `version`, and `errors` array.\n\n**Example prompt:**\n> \"Validate my soul file at ~/agents/marcus.soul.md\"\n\n---\n\n### `generate_soul_template`\n\nGenerates a starter `.soul.md` for a given agent name and keywords.\n\n**Parameters:**\n- `name` (string, required) — the agent's name\n- `keywords` (string[], optional) — domain keywords to seed the template\n\n**Returns:** A ready-to-edit soul file as a string.\n\n**Example prompt:**\n> \"Generate a soul template for a climate scientist who specializes in carbon capture\"\n\n---\n\n### `score_soul_file`\n\nReturns a completeness score (0–100) based on how many optional fields are filled.\n\n**Parameters:**\n- `path` (string, required) — path to the soul file\n\n**Returns:** JSON with `score`, `filled`, `missing`, and `total`.\n\n**Example prompt:**\n> \"Score my agent at ~/agents/startup-advisor.soul.md and tell me what's missing\"\n\n---\n\n## Spec & examples\n\nFull specification: [soul-spec](https://github.com/AntonioTF5/soul-spec)\n\nCurated community soul files: [awesome-soul-files](https://github.com/AntonioTF5/awesome-soul-files)\n\nCLI validator (no Claude required): [soul-md-cli](https://www.npmjs.com/package/soul-md-cli)\n\n---\n\n*MIT License. Created by [Anton Agafonov](https://agenturo.app).*\n",
  "bytes": 2209,
  "sha": "516ef017cb9fc66e52eaa908355fff7d68e253931409b81219468d9dda0d5641",
  "repo_slug": "antoniotf5/soul-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_antoniotf5_soul_mcp_server_850b27da/readme"
}