Skip to content
MCP server

MCP

Screen documents for edits, failed redactions and prompt injection before agents read them

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API, Web
Runs
Locally
Version
1.43.0
Listing updated
2 days ago

About MCP

MCP is a freemium MCP server for security. It runs locally on your machine and is started by your AI client.

Tamperlens looks at what a file's structure records rather than what it shows on screen. For PDFs that includes revisions appended after the original save, metadata fields that contradict each other, editor fingerprints in the Producer field and signatures that no longer cover the whole file. It also checks whether a redaction removed anything, since a black box drawn over text hides it from a reader but not from the file, and whether a document carries text addressed to a language model. The site frames results as risk signals with raw evidence, not verdicts.

The npm package runs locally over stdio. Five tools cover a full inspection, a cheaper triage pre-flight, redaction checks, comparison against an original, and a multi-document case check for inconsistencies between files from one case. It accepts PDF, Word, Excel, PowerPoint and common image formats. Local paths or http(s) URLs can be passed, with URLs fetched on your machine and blocked from reaching private or metadata addresses.

The README warns that the path argument reads any local file and sends its bytes to the API; an optional environment variable confines reads to allowed directories. Without a key, 10 documents an hour are allowed; a free key gives 50 a month, and compare_documents and inspect_case need a key.

Install

Run in a terminal

claude mcp add mcp --env TAMPERLENS_API_KEY='<TAMPERLENS_API_KEY>' -- npx -y tamperlens-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tamperlens-mcp"
      ],
      "env": {
        "TAMPERLENS_API_KEY": "<TAMPERLENS_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tamperlens-mcp"
      ],
      "env": {
        "TAMPERLENS_API_KEY": "<TAMPERLENS_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tamperlens-mcp"
      ],
      "env": {
        "TAMPERLENS_API_KEY": "<TAMPERLENS_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tamperlens-mcp"
      ],
      "env": {
        "TAMPERLENS_API_KEY": "<TAMPERLENS_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tamperlens-mcp"
      ],
      "env": {
        "TAMPERLENS_API_KEY": "<TAMPERLENS_API_KEY>"
      }
    }
  }
}

Configuration

  • TAMPERLENS_API_KEYOptional. Without it the anonymous allowance applies (10 documents/hour); a free key from tamperlens.com/account raises it. compare_documents and inspect_case require a key.
  • TAMPERLENS_BASE_URLOptional. Defaults to the public deployment at https://tamperlens.com.
  • TAMPERLENS_ALLOWED_DIRSOptional. Colon- or comma-separated absolute directories to confine local file reads to. Unset means any absolute path the process can read (the default). Set it to an intake directory so a path argument cannot reach secrets like ~/.ssh or a stray .env; symlinks out of a root are resolved and refused.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

inspect_document
Checks whether a document was edited, including hidden text, macros, image AI traces and text addressed to a language model.
triage_document
Cheap pre-flight returning risk band, cost measures and the checks it skipped.
check_redaction
Checks whether a redaction actually removed content.
compare_documents
Checks whether a file is unchanged from the original you hold.
inspect_case
Checks whether the documents of one case disagree with each other.

What it does

Edit detection
inspect_document flags appended revisions, conflicting metadata, editor traces and signature coverage.
Redaction check
check_redaction tests whether a redaction actually removed the covered content.
Prompt-injection screen
Reports whether a file carries text meant for a model rather than a reader.
Cheap triage
triage_document is a lightweight pre-flight that names the checks it skipped.
Case consistency
inspect_case compares 2 to 10 documents for shared traces they should not have.
Directory confinement
TAMPERLENS_ALLOWED_DIRS limits which local folders the server may read.

Good for

  • Screen a bank statement or payslip before an onboarding agent reads it
  • Confirm a redacted file really removed the hidden text
  • Check whether a file matches the original you hold
  • Route incoming documents with a quick triage before full inspection
  • Compare three months of statements for suspicious overlap

Pricing

Freemium, from $29 a month

Free: 50 documents/month; Solo $29/mo for 1,000; Team $199/mo for 10,000; Business $749/mo for 50,000; credit packs from $0.04 per document

Prices change. Check tamperlens.com before you buy.

MCP FAQ

Does it need an API key?

No for basic use, which allows 10 documents an hour. A free key raises that to 50 a month, and two tools require one.

Which files are supported?

PDF, Word, Excel and PowerPoint, including macro-enabled types, plus JPEG, PNG, WebP, HEIC/HEIF and AVIF.

Can it fetch a URL safely?

Yes, fetching happens on your machine, only http/https, with private and metadata addresses refused.

Does it prove a document is genuine?

No. It reports signals and evidence, and the site says a document generated cleanly from scratch carries no editing traces.

How do I restrict local file access?

Set TAMPERLENS_ALLOWED_DIRS to the directories reads may use.

Is MCP free?

MCP has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

How do I add MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp --env TAMPERLENS_API_KEY='<TAMPERLENS_API_KEY>' -- npx -y tamperlens-mcp

What are the best alternatives to MCP?

The closest alternatives to MCP are REA, Agent Roast, Midplane, Leash and ASTra.

Alternatives to MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents