Skip to main content
Glama
Sign In
mcp-contradiction-check

mcp-contradiction-check

by onetrueclaude-creator
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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

Related MCP server: Vault Knowledge MCP Server

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

Available Tools

4 tools
check_pairA
Read-only

Run the full contradiction check between two specific notes. Accepts absolute paths or filename stems (within a vault that can be inferred).

Inputs: note_a_path (required), note_b_path (required). Returns: result

extract_claimsC
Read-only

[Pro] Pull all quantitative claims (numbers with units) and negation patterns from a single note — structured output for your verification pipeline.

Inputs: note_path (required). Returns: result

find_contradictionsB
Read-only

Scan the vault for note pairs with high concept overlap but conflicting numerical or qualitative claims.

Inputs: vault_path (required), limit, min_shared_concepts. Returns: result

generate_reconciliation_promptA
Read-only

[Pro] For a detected contradiction between two notes, produce a structured LLM-ready prompt for reasoning through the conflict and suggesting resolution.

Inputs: note_a_path (required), note_b_path (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.7/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: scanning all notes, checking a specific pair, extracting claims from a single note, and generating a reconciliation prompt. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (find_contradictions, check_pair, extract_claims, generate_reconciliation_prompt).

    Tool Count5/5

    With 4 tools, the server is well-scoped for its domain of contradiction detection. Each tool serves a necessary function without redundancy or excess.

    Completeness5/5

    The tool set covers the complete workflow: discovery of contradictions, detailed analysis of specific pairs, extraction of claims for verification, and generation of resolution prompts. No obvious gaps for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-contradiction-check

      ermintoygar
      A
      license
      Not graded
      quality
      D
      maintenance
      Detects contradictions in markdown vaults by finding note pairs with high concept overlap but conflicting quantitative or negation claims. Helps prevent knowledge corruption by surfacing disputes before they propagate.
      MIT

    • memory-garden

      drephantom
      A
      license
      B
      quality
      C
      maintenance
      Enables read-only cognitive retrospect over Obsidian notes, surfacing stance changes, verifying claims with citable evidence, and avoiding unfounded causal stories via hybrid retrieval and eight read-only MCP tools.
      9
      10
      MIT