Masquerade MCP: Redact. Replace. Retain Control.

🤐 Problem: Tools like Claude or GPT are incredibly powerful, but they require raw input. If you're dealing with contracts, medical records, or internal documents, that's risky.

🛡️ Solution: Masquerade acts as a privacy firewall for your files. Just paste in the file path to a PDF, and Masquerade will:

• Automatically detect sensitive data (names, emails, dates, entities)
• Redact the sensitive data
• Let you preview before sending to an LLM

Architecture

1. User Input: The user asks Claude to redact a PDF by providing its file path.
2. PDF Processing: MCP reads the PDF and converts it to text.
3. Sensitive Data Detection: The text is sent to Tinfoil (an isolated AI platform using Llama 3.3 70B) to identify sensitive data.
4. Redaction: MCP removes the sensitive data and creates a redacted PDF.
5. Summary Return: MCP sends Claude a summary with:
   • Masked versions of the sensitive data
   • Redaction counts per page
   • The path to the redacted file
6. Quering PDF with Claude: The user can upload the redacted PDF to Claude if satisfied with the redactions.

Installation

1. Install Claude desktop
2. Get Tinfoil API key (create account and API key)
3. Configure environment

curl -O https://raw.githubusercontent.com/postralai/masquerade/main/setup.sh && bash setup.sh

python3.12 -m venv pdfmcp
source pdfmcp/bin/activate
python --version

pip install git+https://github.com/postralai/masquerade@main

python -m masquerade.configure_claude

{
  "mcpServers": {
    "pdf-redaction": {
      "command": "/path/to/python", // Run `which python`
      "args": ["/path/to/mcp_pdf_redaction.py"], // Run `python -c "import masquerade as m; print(f'{m.__path__[0]}/mcp_pdf_redaction.py')"`
      "env": {
        "TINFOIL_API_KEY": "your_api_key" // Create Tinfoil account and paste API key
      }
    }
  }
}

How to use?

1. Prompt Claude: "Redact sensitive information from this PDF: /path/to/filename.pdf"
2. MCP opens the redacted and highlighted PDF files
3. Manually upload the redacted PDF to Claude for quering

Note: Don't upload the original PDF to Claude, only the file path.

Contributing

If you have a fix or improvement, feel free to submit a pull request. For significant changes, please open an issue first to discuss your proposed updates.

See the Developer section for the installation of this repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Need Help?

For questions and common issues, please see the FAQ section or open an issue on GitHub.