Summary
Runs static analysis on your markdown vault to catch notes that cite conflicting numbers or make opposing claims about the same concepts. The find_contradictions tool scans for pairs with high semantic overlap but disagreeing quantitative values or negation patterns, while check_pair lets you audit two specific files. Free tier covers detection, Pro tier adds extract_claims for pulling structured assertions from individual notes and generate_reconciliation_prompt to build LLM inputs that preserve full context for dispute resolution. Built to complement hebbian-vault's retrieval weighting so you don't reinforce contradictory knowledge. Useful if you maintain a growing knowledge base where stale or conflicting information creeps in across hundreds of notes and you need automated flagging before the inconsistencies propagate.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
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
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
CONTRADICTION_CHECK_LICENSEsecretPro license JWT (optional). Unlocks premium features. See README.
Categories
Registryactive
Packagemcp-contradiction-check
TransportSTDIO
AuthRequired
UpdatedApr 18, 2026
