mcp-contradiction-check

Find where your notes disagree — contradiction detection for markdown vaults.

Find pairs of notes in your markdown knowledge base that have high concept overlap but disagree — quantitative conflicts (different numbers with the same unit on the same concept) and negation conflicts (one note claims "X is not Y", another claims "X is Y"). Prevents knowledge corruption by surfacing disputes before they propagate. Designed to pair with hebbian-vault's usage-weighted retrieval to flag notes that shouldn't be strengthened yet.

Install

pip install mcp-contradiction-check
# or
uvx mcp-contradiction-check

Usage

Claude Code

claude mcp add mcp-contradiction-check -- mcp-contradiction-check

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "contradiction_check": {
      "command": "uvx",
      "args": ["mcp-contradiction-check"]
    }
  }
}

MCP Tools

Pro tier

Unlocks detailed claim extraction per note and LLM-ready reconciliation prompt generation for resolving disputes.

License activation — any one of these works:

# 1. Environment variable
export CONTRADICTION_CHECK_LICENSE="eyJhbGc..."

# 2. CLI flag
mcp-contradiction-check --license-key "eyJhbGc..."

# 3. Config file
echo "eyJhbGc..." > ~/.mcp-contradiction-check/license.jwt

Licenses are verified fully offline — no phone-home, no activation server. Get a license at https://github.com/onetrueclaude-creator/mcp-contradiction-check#pro-tier.

Requirements

• Python 3.10+

License

MIT