VirusTotal MCP Server
Provides tools for malware analysis, URL scanning, domain/IP reputation, threat hunting, and community interaction through the VirusTotal API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@VirusTotal MCP Server Scan the URL https://example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
VirusTotal MCP Server (https://mcp.so/server/virustotal-mcp/yassinech-99)
A Model Context Protocol (MCP) server that enables LLMs to interact with the VirusTotal API for malware analysis, URL scanning, and threat intelligence.
🚀 Features
File Analysis: Upload files or retrieve reports via MD5, SHA-1, or SHA-256 hashes.
URL & Domain Intelligence: Scan URLs and get reputation reports for domains.
IP Reputation: Look up threat data associated with specific IP addresses.
Threat Hunting: Perform advanced searches using VirusTotal query syntax.
Community Interaction: Post comments on files, URLs, domains, or IPs.
Related MCP server: ADEO CTI MCP Server
📋 Prerequisites
VirusTotal API Key: Obtain one from VirusTotal.
Python 3.13+: Required as per
pyproject.toml.uv: Recommended for fast dependency management.
🛠Installation
1. Clone & Setup
git clone https://github.com/your-username/virustotal-mcp.git
cd virustotal-mcpConfigure Environment Create a .env file in the root directory:
VIRUSTOTAL_API_KEY=your_api_key_here
API_BASE_URL=https://www.virustotal.com/api/v3
REQUEST_TIMEOUT=30.0Install Dependencies
uv pip install -e .🔌 Claude Desktop Configuration Add this to your claude_desktop_config.json:
{
"mcpServers": {
"virustotal": {
"command": "uv",
"args": [
"--directory",
"D:\\coolAI\\mcp-client",
"run",
"virustotal_mcp.py"
],
"env": {
"VIRUSTOTAL_API_KEY": "<api_key_here>",
"API_BASE_URL": "https://www.virustotal.com/api/v3",
"REQUEST_TIMEOUT": "30.0"
}
}
}
}🛠Available Tools
Tool | Description |
| Upload a local file for analysis. |
| Get reports via hash. |
| Scan and analyze URLs. |
| Domain-specific threat intel. |
| IP address reputation. |
| Search VT intelligence. |
| Add community notes to resources. |
Available Tools
8 toolsvirustotal_get_domain_reportD
Inputs: params (required). Returns: result
virustotal_get_file_reportD
Inputs: params (required). Returns: result
virustotal_get_ip_reportD
Inputs: params (required). Returns: result
virustotal_get_url_reportD
Inputs: params (required). Returns: result
virustotal_post_commentD
Inputs: params (required). Returns: result
virustotal_scan_fileD
Inputs: params (required). Returns: result
virustotal_scan_urlD
Inputs: params (required). Returns: result
virustotal_searchD
Inputs: params (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct VirusTotal resource and action: file scan/report, URL scan/report, domain report, IP report, comment posting, and search. The paired scan/get tools are clearly differentiated by verb, so an agent should not confuse them.
All tools use a consistent virustotal_ prefix with snake_case and action-first naming (scan_file, get_file_report, post_comment). The lone 'search' is slightly more general but still follows the prefix and casing convention.
Eight tools is well-scoped for a VirusTotal MCP server. It covers the main object types and operations without bloating the surface with rarely used endpoints.
Core workflows are covered: scanning files/URLs and retrieving file/URL/domain/IP reports, plus search and commenting. Minor gaps remain around comment retrieval/management and possibly advanced analysis features, but no critical dead end for typical threat-intel queries.
Maintenance
Related MCP Connectors
Official VirusTotal MCP server: threat reports, file and URL submissions, and analysis recovery.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
VirusTotal MCP — file / URL / domain / IP reputation (BYO key)
Related MCP Servers
- AlicenseAqualityBmaintenanceA MCP server for querying the VirusTotal API. This server provides tools for scanning URLs, analyzing file hashes, and retrieving IP address reports.11155MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides access to Shodan and VirusTotal APIs for cybersecurity analysis, enabling analysts to perform network intelligence operations including host lookups, vulnerability analysis, and threat intelligence gathering.27MIT
- AlicenseNot gradedqualityFmaintenanceA Model Context Protocol server that enables AI assistants to perform YARA rule-based threat analysis on files and URLs, supporting comprehensive rule management and detailed scanning results.23MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that integrates with the MISP (Malware Information Sharing Platform) to provide threat intelligence capabilities to Large Language Models.13-