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

Tool	Tier	Description
find_contradictions	Free	Scan the vault for note pairs with high concept overlap but conflicting numerical or qualitative claims. Returns all detected conflicts with the specific issues flagged.
check_pair	Free	Run the full contradiction check between two specific notes (by path or filename stem). Returns the detailed conflict analysis — shared concepts, quantitative conflicts, negation conflicts.
extract_claims	Pro	Pull all quantitative claims (numbers with units) and negation patterns from a single note. Useful as input to your own verification pipeline.
generate_reconciliation_prompt	Pro	For a detected contradiction, produce a structured prompt you can feed to an LLM to reason through the conflict and suggest a resolution. Preserves the exact claims + shared concepts + both notes' context windows.

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