Back to Browse

Manoma MCP Server

Developer ToolsLow Risk9.7MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP server for soul.md — your portable AI identity layer across every LLM.

About

MCP server for soul.md — your portable AI identity layer across every LLM.

Security Report

9.7
Low Risk9.7Low Risk

Valid MCP server (2 strong, 3 medium validity signals). No known CVEs in dependencies. ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

6 files analyzed · 1 issue 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.

file_system

Check that this permission is expected for this type of plugin.

database

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Path to your soul.md file. Defaults to ~/soul.md if not set.Optional

Environment variable: SOUL_MD_PATH

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-paperdavid-manoma": {
      "env": {
        "SOUL_MD_PATH": "your-soul-md-path-here"
      },
      "args": [
        "-y",
        "manoma-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

soul.md

Your identity, not theirs. One file, every AI.

soul.md is an open format for your AI identity — values, voice, skills, taste. A plaintext file you own, version in git, and carry between tools. Manoma is the reference MCP server that makes any LLM read your soul.md.

  • User-owned — lives on your machine, in your repo. No cloud, no account, no vendor.
  • Portable — works with Claude Desktop, Cursor, Zenflow, and any MCP-aware client.
  • Built to outlive models — git-diffable, forkable, versioned. A format, not a walled garden.

See the soul.md format specification.


Install

One line in your Claude Desktop, Cursor, or Zenflow config:

{
  "mcpServers": {
    "manoma": {
      "command": "npx",
      "args": ["-y", "manoma-mcp"]
    }
  }
}

Then drop your soul.md at ~/soul.md.

Get a soul.md

  • Web buildermanoma.ai/build — fill the form, download the file.
  • Templatecp templates/founder.md ~/soul.md (also: engineer.md, designer.md, pm.md).

Tools the MCP server exposes

Readget_context(mode?), get_injection(mode?, message?), get_skill_depth(skill), list_sections().

Write-backadd_decision(...), add_lesson(...), update_now(...).

Resources expose every section as soul://section/<path>, plus soul://full for the whole file.

Full details in mcp/README.md and SPEC.md.


Repo

manoma/
├── mcp/         — MCP server (npx manoma-mcp)
├── templates/   — starter soul.md files
├── SPEC.md      — format specification
└── README.md

Philosophy

Every AI vendor wants to own your memory. soul.md is the opposite bet: your identity as a plaintext file you control, interchangeable between tools, diff-able in git, outliving any individual model.

The schema is the thing. The runtime is just how it's read.

Contributions, forks, and parallel implementations welcome.

MIT.

Reviews

No reviews yet

Be the first to review this server!