Skip to main content
Glama
VirusTotal MCP Server

VirusTotal MCP Server

by yassinech-99

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

  1. VirusTotal API Key: Obtain one from VirusTotal.

  2. Python 3.13+: Required as per pyproject.toml.

  3. uv: Recommended for fast dependency management.

🛠 Installation

1. Clone & Setup

git clone https://github.com/your-username/virustotal-mcp.git
cd virustotal-mcp
  1. Configure 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.0
  1. Install 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

virustotal_scan_file

Upload a local file for analysis.

virustotal_get_file_report

Get reports via hash.

virustotal_scan_url / virustotal_get_url_report

Scan and analyze URLs.

virustotal_get_domain_report

Domain-specific threat intel.

virustotal_get_ip_report

IP address reputation.

virustotal_search

Search VT intelligence.

virustotal_post_comment

Add community notes to resources.

Available Tools

8 tools
virustotal_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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.1/5.0

    Scored across 8 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      A MCP server for querying the VirusTotal API. This server provides tools for scanning URLs, analyzing file hashes, and retrieving IP address reports.
      11
      155
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      27
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      A 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.
      23
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that integrates with the MISP (Malware Information Sharing Platform) to provide threat intelligence capabilities to Large Language Models.
      13
      -