English Français العربية

io.github.onetrueclaude-creator/mcp-contradiction-check

Official registry Productivity

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-contradiction-check
Claude Code 
claude mcp add mcp-contradiction-check -e 'CONTRADICTION_CHECK_LICENSE=<your contradiction_check_license>' -- uvx mcp-contradiction-check==0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-contradiction-check": {
            "command": "uvx",
            "args": [
                "mcp-contradiction-check==0.1.0"
            ],
            "env": {
                "CONTRADICTION_CHECK_LICENSE": "<your contradiction_check_license>"
            }
        }
    }
}

Environment variables

  • CONTRADICTION_CHECK_LICENSE secret Pro license JWT (optional). Unlocks premium features. See README.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-contradiction-check
  2. Install
  3. Usage
  4. MCP Tools
  5. Pro tier
  6. Requirements
  7. License

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

ToolTierDescription
find_contradictionsFreeScan 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_pairFreeRun 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_claimsProPull all quantitative claims (numbers with units) and negation patterns from a single note. Useful as input to your own verification pipeline.
generate_reconciliation_promptProFor 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

Frequently asked questions

What is io.github.onetrueclaude-creator/mcp-contradiction-check?

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

How do I install io.github.onetrueclaude-creator/mcp-contradiction-check?

It runs on your machine. In Claude Code: claude mcp add mcp-contradiction-check -e 'CONTRADICTION_CHECK_LICENSE=<your contradiction_check_license>' -- uvx mcp-contradiction-check==0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.onetrueclaude-creator/mcp-contradiction-check need an API key?

Yes. It expects CONTRADICTION_CHECK_LICENSE, which you set in its configuration.

Is io.github.onetrueclaude-creator/mcp-contradiction-check open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.onetrueclaude-creator/mcp-contradiction-check?

It is published by onetrueclaude-creator. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.