Skip to content

tylabs/malwaretracker-mcp

v2.3.0MIT

Scan PDFs, Office documents, emails, and RAG inputs in <100ms for weaponized malware exploits, macros, CVEs, and hidden AI prompt-injection payloads.

MalwareTracker & QuickSand MCP Server (malwaretracker-mcp)

Official Model Context Protocol (MCP) server for MalwareTracker.com and QuickSand.

Inspect untrusted PDFs, Microsoft Office documents (DOC, DOCX, XLS, XLSX, PPT, PPTX, RTF, OneNote), emails (EML, MSG), and RAG ingestion inputs in <100ms for:

  • Weaponized Document Exploits & Macros — 239+ YARA signatures covering 67+ Office/PDF CVEs, OLE2/OOXML stream unpacking, VBA stomping, XLM macros, and encrypted VelvetSweatshop payloads.
  • Hidden AI / RAG Prompt Injection — Invisible PDF rendering (3 Tr), zero-point font overrides, <w:vanish/> hidden OOXML instructions, spoofed <tool_call> tags, and Markdown data-exfiltration beacons.
  • Zero-Retention Compliance — In-memory scanning (?store=false) for SOC 2, HIPAA, and ISO 27001 workflows.

Get a free API key (100 scans/month) at https://api.malwaretracker.com/portal.


Quickstart

Option A: 1-Click Plugin Install (Google Antigravity, Claude Code, Cursor)

  • Google Antigravity:
    agy plugin install https://github.com/tylabs/malwaretracker-mcp
    
  • Claude Code:
    /plugin marketplace add tylabs/malwaretracker-mcp
    /plugin install malwaretracker@malwaretracker
    
  • Agent Skills (skills.sh):
    npx skills add tylabs/malwaretracker-mcp
    

Option B: Hosted Remote Streamable HTTP + OAuth 2.1 (Zero local install)

  • Claude.ai / OAuth 2.1 Connectors: Connect directly to https://api.malwaretracker.com/mcp/oauth (supports OAuth 2.1 + PKCE S256, Dynamic Client Registration, Google Sign-In, and API key auth).
  • Bearer / Header Streamable HTTP (https://api.malwaretracker.com/mcp):
    {
      "mcpServers": {
        "malwaretracker-remote": {
          "type": "streamable-http",
          "url": "https://api.malwaretracker.com/mcp",
          "headers": {
            "Authorization": "Bearer mt_live_YOUR_API_KEY"
          }
        }
      }
    }
    

Option C: Local stdio via uvx (Recommended for scanning local disk paths)

Add to claude_desktop_config.json, .cursor/mcp.json, or Windsurf / VS Code MCP settings:

{
  "mcpServers": {
    "malwaretracker": {
      "command": "uvx",
      "args": ["malwaretracker-mcp"],
      "env": {
        "MALWARETRACKER_API_KEY": "mt_live_YOUR_API_KEY"
      }
    }
  }
}

Or install with pip:

pip install malwaretracker-mcp

Available MCP Tools

ToolDescriptionQuota Cost
quicksand_scan_documentScan a local file_path, content_base64, or text_content in <100ms for document malware, CVEs, and AI prompt injection (store=false zero-retention).1 scan
quicksand_triage_documentFast Tier-0 SOAR phishing triage returning allow, detonate_in_sandbox, or quarantine_and_detonate plus CVE/MITRE/AI-safety verdicts.1 scan
malwaretracker_lookup_hashLook up cached threat intelligence & stream analysis reports by MD5, SHA1, SHA256, or SHA512.Free
malwaretracker_list_yara_catalogSearch MalwareTracker's YARA signature catalog, CVEs, MITRE ATT&CK IDs, and AI prompt-injection rules.Free (no key needed)
malwaretracker_get_quotaCheck active MalwareTracker plan, monthly usage, and remaining scan quota.Free

Built-in MCP Prompt

  • audit_untrusted_document(file_path) — Enforces a pre-ingestion security audit before an AI agent reads or summarizes an untrusted document.

LangChain / LlamaIndex Python Guardrail

malwaretracker-mcp also bundles SafeQuickSandDocumentGuard for Python RAG pipelines:

from malwaretracker_mcp import SafeQuickSandDocumentGuard

guard = SafeQuickSandDocumentGuard(api_key="mt_live_YOUR_API_KEY")
verdict = guard.verify_file("candidate_resume.pdf")
# Raises PermissionError in <100ms if an exploit or hidden prompt injection is detected!

Links