mcpField
L
LLMVerify

LLMVerify

Local
github.com/subodhkcSecurity18Updated 3w ago

About LLMVerify

LLMVerify is a local-first verification layer for applications using LLMs. It provides pattern-based checks for output risks, input injections, and PII, with a built-in MCP server for compatible clients.

Key features

  1. 01Hallucination and safety risk checks
  2. 02Prompt-injection and jailbreak detection
  3. 03PII detection and redaction
  4. 04Broken JSON repair
  5. 05LLM latency and behavior monitoring
  6. 06Local audit logging

Use cases

  1. 01Screen model responses before showing them
  2. 02Check user input before sending it to an LLM
  3. 03Mask personal data in generated text
  4. 04Run model regression checks

MCP support

Its built-in MCP server exposes six tools for content verification, hallucination risk, prompt-injection checks, PII checks and redaction, and capability discovery. It communicates over stdio and makes no outbound network requests.

Configuration

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

mcp.json · Universal config
{
"mcpServers": {
"subodhkc-llmverify": {
"command": "npx",
"args": [
"-y",
"llmverify"
],
"env": {
"LLMVERIFY_MCP_MAX_INPUT_CHARS": "<LLMVERIFY_MCP_MAX_INPUT_CHARS>",
"LLMVERIFY_MCP_TIMEOUT_MS": "<LLMVERIFY_MCP_TIMEOUT_MS>",
"LLMVERIFY_MCP_MAX_OUTPUT_ITEMS": "<LLMVERIFY_MCP_MAX_OUTPUT_ITEMS>",
"LLMVERIFY_MCP_MAX_TEXT_FIELD_CHARS": "<LLMVERIFY_MCP_MAX_TEXT_FIELD_CHARS>",
"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": "<LLMVERIFY_AUDIT_HASH_KEY>",
"LLMVERIFY_AUDIT_NO_CONTENT_HASH": "<LLMVERIFY_AUDIT_NO_CONTENT_HASH>"
}
}
}
}
Run commandnpx -y llmverify
Environment variables to set
LLMVERIFY_MCP_MAX_INPUT_CHARSMax characters accepted in a content/input argument
LLMVERIFY_MCP_TIMEOUT_MSPer-tool wall-clock timeout in milliseconds
LLMVERIFY_MCP_MAX_OUTPUT_ITEMSCap on any single output array
LLMVERIFY_MCP_MAX_TEXT_FIELD_CHARSCap on any single text field in output
LLMVERIFY_HOMEBase directory for engine local state
LLMVERIFY_AUDIT_DIRAudit JSONL directory
LLMVERIFY_LOG_DIROperational log directory
LLMVERIFY_BASELINE_DIRDrift baseline directory
LLMVERIFY_USAGE_FILEUsage counter file
LLMVERIFY_AUDIT_HASH_KEYSecretEnables keyed hmac-sha256 content hashes in audit records
LLMVERIFY_AUDIT_NO_CONTENT_HASHSet to 1 to disable content hashes in audit records

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
npmllmverify1.8.0

Tools

6

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
isJSONbooleanNoDeclare that content is intended as JSON. Gates the JSON validator onto non-JSON input and affects which engines run.
contentstringYesAI-generated text to evaluate. Never executed.
profileenumNoCSM6 evaluation profile applied to this call (config.csm6.profile).baseline | high_risk | finance | health | research
skipEnginesarrayNoEngine identifiers to skip for this call. The adapter maps the public id jsonValidator onto the engine-internal id "json". Skipped engines are reported in notChecked under their engine-internal names — never as success.
expectedSchemaobjectNoJSON Schema object the JSON validator should check content against. Only meaningful with isJSON: true.
requireAuditPersistencebooleanNoEvidence-required mode. When true, the tool fails unless the audit record is actually PERSISTED (FAILED, DISABLED and NOT_ATTEMPTED all escalate to a typed error).

Details

From the project README

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.

npm version CI License: MIT

Last Updated: August 21, 2026 Version: 1.7.0 Node: >= 18.0.0 License: MIT


Links


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

FunctionOne-linerWhat 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, ciVerifyawait 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


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.

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.