# JidoSeal

A local MCP server reads the YAML frontmatter of every *.md in a folder, names the knowledge base tier, and lists the fields each file still needs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: Jidoseal
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Jidoseal/jidoseal-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/jidoseal

## What it does

Point it at a folder of markdown notes and it walks every `*.md` file. Only populated frontmatter fields count — a `title:` with nothing after it earns nothing. The result tells you which tier (Bronze, Silver, Gold) the corpus reaches and what each file is missing for the next one. A corpus takes the tier of its weakest file, so a single note without frontmatter drags the whole folder down.

The scan is deterministic: no model calls, no opinion-based scoring. Gaps come back marked `AUTO` (a value JidoSeal can propose) or `NEEDS-CLIENT` (only you can answer). Two more tools, `jidoseal_trust` and `jidoseal_changes`, are read-only; the second shells out to the local `git` program with transports disabled to read folder history. The server writes exactly two files under `<folder>/.jidoseal/`: `manifest.json` and `progress.ndjson`. Your notes stay untouched.

The scan engine is a separate `jidoseal` package under a proprietary licence, pinned here to one version. "Nothing leaves your machine" is JidoSeal's own claim about that engine, not an independent audit — the README's network section and the tests in `tests/` are how you check it. A folder holding a symlink to a directory or to a file outside itself gets refused. The paid `jidoseal_start_checkout` runs only with `confirm: true` and sends eight fields to jidoseal.com, among them the Merkle root and a 0–100 score.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add jidoseal-mcp -- uvx jidoseal-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from jidoseal-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add jidoseal -- uvx jidoseal-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from jidoseal-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "jidoseal": {
            "command": "uvx",
            "args": [
                "jidoseal-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from jidoseal-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "jidoseal": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "jidoseal-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from jidoseal-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add jidoseal uvx jidoseal-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from jidoseal-mcp <command>

## When to use it
- find which frontmatter fields each file needs for Silver
- work out the tier of a whole notes corpus
- spot markdown files with no YAML frontmatter
- read a folder's history through the local `git`
- check a folder before paying for a certificate

## Example prompts
- Scan ~/notes with JidoSeal and tell me what's missing for Silver.
- List the files that have no frontmatter.

## Similar
- [okf-knowledge-base](https://affpapa.org/en/nevibecode/skills/okf-knowledge-base.md) — skill · 9300 installs
- [visualize](https://affpapa.org/en/nevibecode/skills/visualize.md) — skill · 849 installs
- [arquiteto-de-empresa](https://affpapa.org/en/nevibecode/skills/arquiteto-de-empresa.md) — skill · 51 installs
- [rspress-description-generator](https://affpapa.org/en/nevibecode/skills/rspress-description-generator.md) — skill · 498 installs
- [markdown-content-creation](https://affpapa.org/en/nevibecode/rules/markdown-content-creation.md) — rule · ★ 40451
- [shared](https://affpapa.org/en/nevibecode/skills/shared.md) — skill · 456 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md