Skip to main content

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

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

Or add directly in Claude Code:

claude mcp add malwaretracker -e MALWARETRACKER_API_KEY=mt_live_YOUR_API_KEY -- uvx malwaretracker-mcp

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

Connect any Streamable HTTP MCP client directly to 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"
      }
    }
  }
}

Available MCP Tools

Tool Description Quota Cost
quicksand_scan_document Scan 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_document Fast Tier-0 SOAR phishing triage returning allow, detonate_in_sandbox, or quarantine_and_detonate plus CVE/MITRE/AI-safety verdicts. 1 scan
malwaretracker_lookup_hash Look up cached threat intelligence & stream analysis reports by MD5, SHA1, SHA256, or SHA512. Free
malwaretracker_list_yara_catalog Search MalwareTracker's YARA signature catalog, CVEs, MITRE ATT&CK IDs, and AI prompt-injection rules. Free (no key needed)
malwaretracker_get_quota Check 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!

Metadata

Release files for malwaretracker-mcp 2.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for malwaretracker-mcp 2.3.0
File Size Uploaded Provenance Actions
malwaretracker_mcp-2.3.0.tar.gz 11.9 kB Without provenance Details for malwaretracker_mcp-2.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for malwaretracker-mcp 2.3.0
File Interpreter ABI Platform Actions
malwaretracker_mcp-2.3.0-py3-none-any.whl Python 3 none any Details for malwaretracker_mcp-2.3.0-py3-none-any.whl

Total release size: 23.7 kB

Release files / malwaretracker_mcp-2.3.0.tar.gz

Download URL malwaretracker_mcp-2.3.0.tar.gz
Size 11.9 kB
Tags Source
SHA-256 checksum
How to use checksums
3be765f85510608b92ca348456f1991454eecd1ec8b9b9650f5bf3bf36a8efa0
BLAKE2b-256 checksum
How to use checksums
ce571bb275ca31ab45f357c1cba7ecfe8f6cdfe58ec5f5781ea1089322994f4b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / malwaretracker_mcp-2.3.0-py3-none-any.whl

Download URL malwaretracker_mcp-2.3.0-py3-none-any.whl
Size 11.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
18ba61fe6fd57f4a3d62326faa03ed14545114f95be6b63e414df0cb8ccc0a9d
BLAKE2b-256 checksum
How to use checksums
23e093d7e954eec89cf4275b0c01d0c4331f5b91343542dfdba4db704cb4eb8b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Security for malwaretracker-mcp 2.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.3.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page