document-integrity-validator-mcp 1.0.2

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## [1.0.2] - 2026-05-06
+
+### Improved
+
+- Remove redundant UNKNOWN_DOCUMENT_TYPE sentence from check_document description.
+
+## [1.0.1] - 2026-05-06
+
+### Improved
+
+- Improve tool descriptions: add exclusivity framing to both check_document and check_document_package.
+
+## [1.0.0] - 2026-05-06
+
+### Initial release
+
+- `check_document` tool: assesses any document against its known international standard. Free tier: 10 calls/month per IP.
+- `check_document_package` tool: assesses 2-20 related documents individually and cross-checks for numeric, party, reference, date, commodity, and port conflicts. Paid tier only.
+- Vision support: accepts base64 image or extracted text or both.
+- UNKNOWN_DOCUMENT_TYPE verdict for unrecognised documents -- refusal is correct behaviour.
+- Structured verdict with agent_action, assessed_against, known_issuing_standard, and specific flags.
+- Trial extension endpoint: 10 extra free calls per email address via POST /trial-extension.
+- Stripe webhook for automated API key provisioning.
+- getEffectiveLimit() helper for accurate quota display after trial extension.
+- Free tier warning at 8 calls used (2 remaining).
+- checkAccess() runs only inside tools/call branch -- never on tools/list or initialize.

package/LICENSE

@@ -0,0 +1,8 @@
+UNLICENSED
+
+Copyright (c) 2026 Kord Agencies Pte Ltd. All rights reserved.
+
+This software is proprietary and confidential. No licence is granted to use,
+copy, modify, merge, publish, distribute, sublicense, or sell copies of this
+software or any portion of it without the prior written permission of
+Kord Agencies Pte Ltd.

package/README.md

@@ -0,0 +1,147 @@
+# Document Integrity Validator MCP
+
+Before your agent accepts, processes, or acts on any document received from an external party -- verify it is internally consistent and matches the known standard for its type. One call. Any document. Machine-readable verdict.
+
+## What it does
+
+Checks any document for internal consistency, completeness, and anomalies against the known international standard for that document type. Accepts base64 image or extracted text. Returns a structured verdict with a machine-readable `agent_action` field.
+
+Supported standards include: ICAO Document 9303 (passports), Hague-Visby Rules 1968 (bills of lading), UCP 600 (trade finance documents), ISPM 12/IPPC/FAO (phytosanitary certificates), Vienna Convention on Road Traffic 1968 (driving licences), and more.
+
+Returns `UNKNOWN_DOCUMENT_TYPE` rather than guessing on unfamiliar documents -- refusal is correct behaviour, not a failure.
+
+AI-powered reasoning -- NOT a database lookup.
+
+## Tools
+
+### check_document (Free tier: 10 calls/month)
+
+Checks a single document against its international standard.
+
+**Input:**
+- `document_text` (string, optional) -- extracted text from the document
+- `document_image` (string, optional) -- base64 encoded image (raw base64 or data URL)
+- `document_type_hint` (string, optional) -- agent belief about document type
+- `issuing_jurisdiction` (string, optional) -- country or issuing body
+
+At least one of `document_text` or `document_image` is required.
+
+**Response:**
+```json
+{
+  "agent_action": "PROCEED",
+  "verdict": "PASS",
+  "confidence": "HIGH",
+  "document_type_identified": "Bill of Lading",
+  "assessed_against": "Hague-Visby Rules 1968",
+  "known_issuing_standard": "IMO",
+  "flags": [],
+  "reason": "Document is internally consistent and compliant with Hague-Visby Rules 1968.",
+  "analysis_type": "AI-powered reasoning -- NOT a database lookup",
+  "checked_at": "2026-05-06T10:00:00.000Z",
+  "_disclaimer": "..."
+}
+```
+
+**agent_action values:**
+- `PROCEED` -- document passed
+- `VERIFY_MANUALLY` -- flags found, agent should flag for human review
+- `HOLD` -- document failed, do not proceed
+- `REFER_TO_HUMAN` -- document type unknown, refer for manual assessment
+
+### check_document_package (Paid tier only)
+
+Checks 2-20 related documents individually then cross-checks all for consistency conflicts.
+
+**Input:**
+- `documents` (array, min 2, max 20) -- each item has: `label` (required), `document_text`, `document_image`, `document_type_hint`, `issuing_jurisdiction`
+
+**Cross-checks performed:** weights/quantities/amounts, party names, reference numbers, dates, commodity descriptions, port references.
+
+## Pricing
+
+| Tier | Calls | Price |
+|------|-------|-------|
+| Free | 10/month per IP | No API key required |
+| Trial extension | +10 one-time | POST /trial-extension |
+| Pro | 500/month | $29/month |
+| Enterprise | 5,000/month | $199/month |
+
+Overage: $0.05 per call above monthly cap.
+
+Subscribe at [kordagencies.com](https://kordagencies.com).
+
+## Harness Integration
+
+### Claude Code / Claude Desktop (.mcp.json)
+```json
+{
+  "mcpServers": {
+    "document-integrity-validator": {
+      "type": "http",
+      "url": "https://document-integrity-validator-mcp-production.up.railway.app/mcp"
+    }
+  }
+}
+```
+
+### LangChain / LangGraph (Python)
+```python
+from langchain_mcp_adapters.client import MultiServerMCPClient
+client = MultiServerMCPClient({
+    "document-integrity-validator": {
+        "url": "https://document-integrity-validator-mcp-production.up.railway.app/mcp",
+        "transport": "http"
+    }
+})
+tools = await client.get_tools()
+```
+
+### OpenAI Agents SDK (Python)
+```python
+from agents import Agent, HostedMCPTool
+agent = Agent(
+    name="Assistant",
+    tools=[HostedMCPTool(tool_config={
+        "type": "mcp",
+        "server_label": "document-integrity-validator",
+        "server_url": "https://document-integrity-validator-mcp-production.up.railway.app/mcp",
+        "require_approval": "never"
+    })]
+)
+```
+
+## Self-hosted (stdio)
+
+```bash
+npm install -g document-integrity-validator-mcp
+ANTHROPIC_API_KEY=sk-ant-... TRANSPORT=stdio document-integrity-validator-mcp
+```
+
+Add to Claude Desktop `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "document-integrity-validator": {
+      "command": "document-integrity-validator-mcp",
+      "env": { "ANTHROPIC_API_KEY": "sk-ant-..." }
+    }
+  }
+}
+```
+
+## Trial Extension
+
+If you have reached the 10 call/month free limit, request 10 extra calls:
+
+```bash
+curl -X POST https://document-integrity-validator-mcp-production.up.railway.app/trial-extension \
+  -H "Content-Type: application/json" \
+  -d '{"name":"Your Name","email":"you@example.com","use_case":"Brief description"}'
+```
+
+One extension per email address.
+
+## Legal
+
+AI-powered document consistency assessment. Results are for informational purposes only and do not constitute legal, compliance, or authentication advice. We do not log or store your document content. Full terms: [kordagencies.com/terms.html](https://kordagencies.com/terms.html)

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,YAAY,iCAAiC,CAAC;AAC3D,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAC1D,eAAO,MAAM,gBAAgB,gVACkT,CAAC;AAChV,eAAO,MAAM,SAAS,QAAsC,CAAC;AAE7D,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/dist/constants.js

@@ -0,0 +1,12 @@
+export const VERSION = '1.0.0';
+export const PERSIST_FILE = '/tmp/docintegrity_stats.json';
+export const FREE_TIER_LIMIT = 10;
+export const FREE_TIER_WARNING = 8;
+export const TRIAL_EXTENSION_CALLS = 10;
+export const PRO_UPGRADE_URL = 'https://kordagencies.com';
+export const LEGAL_DISCLAIMER = 'AI-powered document consistency assessment. Results are for informational purposes only and do not constitute legal, compliance, or authentication advice. We do not log or store your document content. Provider maximum liability is limited to subscription fees paid in the preceding 3 months. Full terms: kordagencies.com/terms.html';
+export const STATS_KEY = process.env.STATS_KEY ?? 'ojas2026';
+export function nowISO() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,8BAA8B,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAC3B,6UAA6U,CAAC;AAChV,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,UAAU,CAAC;AAE7D,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC"}

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}