docqa-mcp

MCP (Model Context Protocol) server for DocQA — verify AI extraction results against original documents, plus PDF extraction, OCR, and format conversion.

Catches what your AI missed: hallucinated invoice totals, wrong dates, arithmetic errors, mismatched field values — all without sending documents to any LLM.

Quick Start

npx docqa-mcp

Requires DOCQA_API_KEY environment variable. Get your key at: https://api.agentsconsultants.com

Setup

1. Get an API Key

Request a key at api.agentsconsultants.com. Free trial available.

2. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "docqa": {
      "command": "npx",
      "args": ["docqa-mcp"],
      "env": {
        "DOCQA_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Or install globally

npm install -g docqa-mcp

Then configure with command: "docqa-mcp" and your DOCQA_API_KEY env var.

Tools

docqa-verify ⭐ Core Tool

Verify AI-extracted fields against the original document. Detects hallucinations, arithmetic errors, and field mismatches.

Basic tier — Pattern validation + arithmetic checks (no document needed):

{
  "extraction": {
    "invoice_number": "INV-2024-0042",
    "date": "03/15/2024",
    "total": "$1,296.00",
    "subtotal": "$1,200.00",
    "tax": "$96.00"
  }
}

Standard tier — Full cross-extraction with independent OCR/PDF re-parse:

{
  "extraction": { "total": "$1,296.00", "date": "03/15/2024" },
  "document": "<base64-encoded-pdf>",
  "callerTool": "tesseract"
}

Gate mode — Simple pass/fail for agent workflow integration:

{
  "extraction": { ... },
  "mode": "gate"
}

Returns: { "pass": true, "confidence": 0.94, "failReasons": [] }

Pricing:

• Basic: $0.05/verification — pattern + arithmetic checks
• Standard: $0.50/verification — full cross-extraction

docqa-sample

Fetch a sample verification report to understand the output format. Free, no API key needed.

pdf-extract

Extract structured text and tables from PDF documents.

• Input: file (base64 PDF), optional filename
• Output: Extracted text, page count, tables, metadata, text quality assessment
• Tip: If textQuality: "low", the PDF is likely scanned — use ocr instead

ocr

Extract text from images using Tesseract OCR.

• Input: file (base64 image), optional language (default: eng), optional filename
• Supports: PNG, JPG, TIFF, BMP, WebP
• Output: Recognized text, confidence score, character count

convert

Convert documents between formats.

• Input formats: pdf, md, json, txt
• Output formats: txt, md, json
• Input: file (base64), from, to
• Output: Converted document (base64) + size stats

Why DocQA?

AI extraction tools (OCR, LLMs, form recognizers) hallucinate. DocQA independently re-extracts and cross-verifies:

| Problem | DocQA Catch | |---------|-------------| | "Invoice total: $1,296" (actual: $1,269) | ✅ Amount mismatch | | "Date: 2024-03-15" (actual: 2024-03-51) | ✅ Date format invalid | | "Tax: $96, Subtotal: $1,200, Total: $1,394" | ✅ Arithmetic mismatch | | LLM invents a line item not in the PDF | ✅ Unreported field detected |

vs. Competitors

| Feature | docqa-mcp | PDF Extraction MCP | Advanced OCR MCP | Mistral OCR MCP | |---------|-----------|-------------------|-------------------|-----------------| | Cross-extraction verification | ✅ | ❌ | ❌ | ❌ | | Hallucination detection | ✅ | ❌ | ❌ | ❌ | | Arithmetic validation | ✅ | ❌ | ❌ | ❌ | | Gate mode for pipelines | ✅ | ❌ | ❌ | ❌ | | PDF extraction | ✅ | ✅ | ❌ | ✅ | | OCR | ✅ | ❌ | ✅ | ✅ | | Price per doc | $0.05-0.50 | varies | varies | varies |

API Base URL

Default: https://api.agentsconsultants.com

Override: OPENCLAW_API_URL=https://your-instance.com

License

MIT