LLMVerify
Local-first MCP server for LLM output verification — risk signals, injection and PII checks.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
llmverifyclaude mcp add llmverify -e 'LLMVERIFY_MCP_MAX_INPUT_CHARS=1000000' -e 'LLMVERIFY_MCP_TIMEOUT_MS=60000' -e 'LLMVERIFY_MCP_MAX_OUTPUT_ITEMS=50' -e 'LLMVERIFY_MCP_MAX_TEXT_FIELD_CHARS=2000' -e 'LLMVERIFY_HOME=<LLMVERIFY_HOME>' -e 'LLMVERIFY_AUDIT_DIR=<LLMVERIFY_AUDIT_DIR>' -e 'LLMVERIFY_LOG_DIR=<LLMVERIFY_LOG_DIR>' -e 'LLMVERIFY_BASELINE_DIR=<LLMVERIFY_BASELINE_DIR>' -e 'LLMVERIFY_USAGE_FILE=<LLMVERIFY_USAGE_FILE>' -e 'LLMVERIFY_AUDIT_HASH_KEY=<your llmverify_audit_hash_key>' -e 'LLMVERIFY_AUDIT_NO_CONTENT_HASH=<LLMVERIFY_AUDIT_NO_CONTENT_HASH>' -- npx -y llmverify@1.8.0 mcp
{
"mcpServers": {
"llmverify": {
"command": "npx",
"args": [
"-y",
"llmverify@1.8.0",
"mcp"
],
"env": {
"LLMVERIFY_MCP_MAX_INPUT_CHARS": "1000000",
"LLMVERIFY_MCP_TIMEOUT_MS": "60000",
"LLMVERIFY_MCP_MAX_OUTPUT_ITEMS": "50",
"LLMVERIFY_MCP_MAX_TEXT_FIELD_CHARS": "2000",
"LLMVERIFY_HOME": "<LLMVERIFY_HOME>",
"LLMVERIFY_AUDIT_DIR": "<LLMVERIFY_AUDIT_DIR>",
"LLMVERIFY_LOG_DIR": "<LLMVERIFY_LOG_DIR>",
"LLMVERIFY_BASELINE_DIR": "<LLMVERIFY_BASELINE_DIR>",
"LLMVERIFY_USAGE_FILE": "<LLMVERIFY_USAGE_FILE>",
"LLMVERIFY_AUDIT_HASH_KEY": "<your llmverify_audit_hash_key>",
"LLMVERIFY_AUDIT_NO_CONTENT_HASH": "<LLMVERIFY_AUDIT_NO_CONTENT_HASH>"
}
}
}
}
Variables d'environnement
LLMVERIFY_MCP_MAX_INPUT_CHARSMax characters accepted in a content/input argumentLLMVERIFY_MCP_TIMEOUT_MSPer-tool wall-clock timeout in millisecondsLLMVERIFY_MCP_MAX_OUTPUT_ITEMSCap on any single output arrayLLMVERIFY_MCP_MAX_TEXT_FIELD_CHARSCap on any single text field in outputLLMVERIFY_HOMEBase directory for engine local stateLLMVERIFY_AUDIT_DIRAudit JSONL directoryLLMVERIFY_LOG_DIROperational log directoryLLMVERIFY_BASELINE_DIRDrift baseline directoryLLMVERIFY_USAGE_FILEUsage counter fileLLMVERIFY_AUDIT_HASH_KEYsecret Enables keyed hmac-sha256 content hashes in audit recordsLLMVERIFY_AUDIT_NO_CONTENT_HASHSet to 1 to disable content hashes in audit records
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
llmverify
You shipped an AI feature. Your LLM hallucinated a citation, leaked a customer's email, and followed a prompt-injection buried in user input — on the same day. llmverify is the safety layer that sits between your LLM and your users.
Local-first verification, PII redaction, prompt-injection defense, and runtime monitoring for any LLM. One npm install. Zero telemetry. No API keys on the free tier.
Last Updated: August 21, 2026 Version: 1.7.0 Node: >= 18.0.0 License: MIT
Links
- Product page: haiec.com/llmverify
- npm: npmjs.com/package/llmverify
- GitHub: github.com/subodhkc/llmverify-npm
- Python (placeholder): pypi.org/project/llmverify — namespace reservation, not a port of this package
- Author: Subodh Kc
The problem
You build with GPT-4, Claude, Gemini, or any LLM. The model:
- Hallucinates facts and citations that do not exist.
- Leaks PII — emails, phone numbers, SSNs, API keys in responses.
- Follows prompt injections — users trick it into ignoring your instructions.
- Returns broken JSON that crashes your parser.
- Drifts in quality over time, and nobody notices until a user complains.
You need a guardrail between the model and your users. That is llmverify.
Install
npm install llmverify
Everything runs locally. The free tier makes zero network requests and needs no API key. Free tier limit: 500 verification calls per day (tracked locally, never sent anywhere).
What you get
| Function | One-liner | What it does |
|---|---|---|
verify(content) | await verify(aiResponse) | Runs hallucination, consistency, safety, and CSM6 checks; returns a risk level and findings |
isInputSafe(input) | isInputSafe(userMessage) | Blocks prompt injection, jailbreaks, and malicious input before it reaches the model |
redactPII(text) | redactPII(aiResponse) | Masks emails, phones, SSNs, credit cards, and API keys |
containsPII(text) | containsPII(text) | Returns true if PII is present |
detectAndRepairJson(...) | detectAndRepairJson(prompt, response) | Detects and repairs broken JSON output |
monitorLLM(client) | monitorLLM(openaiClient) | Wraps any LLM client; tracks latency, token drift, and behavioral changes |
sentinel.quick(...) | await sentinel.quick(client, model) | Runs regression tests against your model before users see changes |
classify(...) | classify(prompt, response) | Intent detection, hallucination signals, and instruction compliance |
auditLog(event) | auditLog({ ... }) | Appends a local, hash-only audit entry for SOC 2 / HIPAA / GDPR evidence |
run, prodVerify, ciVerify | await prodVerify(content) | Preset pipelines for dev, prod, strict, fast, and CI use |
Quick start (30 seconds)
const { verify, isInputSafe, redactPII } = require('llmverify');
// 1. Block prompt injection before it reaches the model.
if (!isInputSafe(userMessage)) {
return { error: 'Invalid input detected' };
}
// 2. Verify the model's output.
const aiResponse = await yourLLM.generate(userMessage);
const result = await verify(aiResponse);
if (result.risk.level === 'critical') {
return { error: 'Response failed safety check' };
}
// 3. Strip PII before the response reaches a user or a log.
const { redacted } = redactPII(aiResponse);
console.log(redacted);
Three lines of safety between your LLM and your users. No config file required. No API key required.
How it works
llmverify runs deterministic, pattern-based engines locally — no model calls, no network on the free tier. Same input plus same rules equals same result. Every result carries an explicit limitations array stating what was and was not checked, so you never mistake a clean score for a guarantee.
Framework alignment (baseline mapping only — not certification):
- OWASP LLM Top 10
- NIST AI RMF
- EU AI Act
- ISO 42001
- CSM6 (HAIEC's 38-rule control set)
CLI
# Verify a string from the terminal.
npx llmverify verify "The capital of France is London."
# Start a local HTTP API for IDE / tool integration (localhost only by default).
npx llmverify-serve --port=9009
# Expose to the network only on a trusted network. There is no auth on the API.
npx llmverify-serve --host=0.0.0.0 --port=9009
The server binds to 127.0.0.1 by default, restricts CORS to localhost origins, and rate-limits clients (100 requests / 60s). It requires express (an optional dependency that installs by default).
MCP server
llmverify ships a built-in Model Context Protocol server — the same engine, exposed to MCP-compatible agents and IDEs over stdio:
npx llmverify mcp
// MCP client config
{
"mcpServers": {
"llmverify": {
"command": "npx",
"args": ["-y", "llmverify", "mcp"]
}
}
}
Six tools: verify_llm_content, assess_hallucination_risk, check_prompt_injection, check_pii, redact_pii, get_llmverify_capabilities. Stdio-only, zero outbound network, bounded inputs/outputs, PII-filtered responses, honest notChecked/audit semantics.
Requires Node.js ≥ 20 (the MCP SDK's floor; the rest of the package supports ≥ 18). The MCP SDK and zod are regular dependencies — the mcp command lazy-loads them so other commands pay no startup cost.
See docs/MCP.md for the full tool reference and security model.
Limitations
llmverify is a triage tool, not a truth oracle. Be honest with yourself about what it can and cannot do:
- It cannot definitively prove hallucinations. Hallucination signals are pattern-based. "The capital of France is London" scores low because the text looks internally consistent. Ground-truth verification requires a source document you provide.
- It does not replace human review. Use it to triage, not to approve.
- PII detection is regex-based. It catches standard formats (emails, US phones, SSNs, credit cards, common API keys). It misses obfuscated, image-embedded, or encoded PII. Accuracy is roughly 90% for standard formats, lower for variations.
- Prompt-injection detection is pattern-based. Novel or obfuscated injections can evade it.
- Free tier is 100% local. ML-enhanced features require a paid tier and an explicit API key; the free tier never makes network requests and never sends data anywhere.
If a claim matters, verify it yourself. llmverify narrows the risk surface; it does not eliminate it.
Documentation
Part of HAIEC
llmverify is part of the HAIEC (Human AI Evidence Company) AI governance platform. Use it alongside the AI Security Scanner, the CI/CD pipeline integration, and Runtime Injection Testing.
Support
- Issues: GitHub Issues
- Docs: Full documentation
License
MIT — see LICENSE.
Recommendation (not legal advice): Run verify() on every model output that reaches a user, and isInputSafe() on every user input that reaches a model. Treat the risk level as a triage signal, not an approval.
Questions fréquentes
Qu'est-ce que LLMVerify ?
Local-first MCP server for LLM output verification — risk signals, injection and PII checks.
Comment installer LLMVerify ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add llmverify -e 'LLMVERIFY_MCP_MAX_INPUT_CHARS=1000000' -e 'LLMVERIFY_MCP_TIMEOUT_MS=60000' -e 'LLMVERIFY_MCP_MAX_OUTPUT_ITEMS=50' -e 'LLMVERIFY_MCP_MAX_TEXT_FIELD_CHARS=2000' -e 'LLMVERIFY_HOME=<LLMVERIFY_HOME>' -e 'LLMVERIFY_AUDIT_DIR=<LLMVERIFY_AUDIT_DIR>' -e 'LLMVERIFY_LOG_DIR=<LLMVERIFY_LOG_DIR>' -e 'LLMVERIFY_BASELINE_DIR=<LLMVERIFY_BASELINE_DIR>' -e 'LLMVERIFY_USAGE_FILE=<LLMVERIFY_USAGE_FILE>' -e 'LLMVERIFY_AUDIT_HASH_KEY=<your llmverify_audit_hash_key>' -e 'LLMVERIFY_AUDIT_NO_CONTENT_HASH=<LLMVERIFY_AUDIT_NO_CONTENT_HASH>' -- npx -y llmverify@1.8.0 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour LLMVerify ?
Oui. Il attend LLMVERIFY_AUDIT_HASH_KEY, à renseigner dans sa configuration.
LLMVerify est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient LLMVerify ?
Il est publié par subodhkc. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.