mcpField
M
mcp-contradiction-check

mcp-contradiction-check

Local
github.com/onetrueclaude-creatorMemory & Knowledge0Updated 28w ago
Repository

About mcp-contradiction-check

mcp-contradiction-check scans Markdown vaults for notes with overlapping concepts but conflicting claims. It helps people maintain note collections by identifying numerical and negation conflicts, with optional tools for extracting claims and preparing reconciliation prompts.

Key features

  1. 01Detect numerical and negation conflicts
  2. 02Scan a vault for conflicting note pairs
  3. 03Check two notes in detail
  4. 04Extract claims from a note
  5. 05Generate reconciliation prompts

Use cases

  1. 01Review a Markdown vault for conflicting statements
  2. 02Compare two notes before merging or relying on them
  3. 03Extract claims for a verification workflow
  4. 04Prepare a structured prompt to resolve a detected conflict

MCP support

It provides MCP tools for scanning vaults, checking note pairs, extracting claims, and generating reconciliation prompts.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "onetrueclaude-creator-mcp-contradiction-check": {
      "command": "uvx",
      "args": [
        "mcp-contradiction-check"
      ],
      "env": {
        "CONTRADICTION_CHECK_LICENSE": "<CONTRADICTION_CHECK_LICENSE>"
      }
    }
  }
}
Run commanduvx mcp-contradiction-check
Environment variables to set
CONTRADICTION_CHECK_LICENSESecretPro license JWT (optional). Unlocks premium features. See README.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-contradiction-check0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.