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
VelvetSweatshoppayloads. - 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: Local stdio via uvx (Recommended for scanning local files)
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!
Links
- Website & Interactive Scanner: https://malwaretracker.com
- Developer Portal & Free API Key: https://api.malwaretracker.com/portal
- API Reference: https://malwaretracker.com/api.html
- License: MIT
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.