MCP Virustotal logo

MCP Virustotal

by BurtTheCoder

Queries VirusTotal for indicator reports, relationships, searches, behavior summaries, and threat-intelligence collections over MCP.

Install MCP Virustotal

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "burtthecoder-mcp-virustotal": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-virustotal"
      ],
      "env": {
        "VIRUSTOTAL_API_KEY": "YOUR_VALUE_HERE",
        "MCP_TRANSPORT": "YOUR_VALUE_HERE",
        "MCP_HOST": "YOUR_VALUE_HERE",
        "MCP_PORT": "YOUR_VALUE_HERE",
        "MCP_ENDPOINT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

BurtTheCoder/mcp-virustotal connects MCP clients to the VirusTotal v3 API for file, URL, IP address, and domain analysis. It returns reports with related entities, supports relationship pagination, and provides search, sandbox behavior, and collection tools for investigative pivots. Use it when an agent needs VirusTotal intelligence from a desktop workflow or a shared HTTP service. A VirusTotal API key and Node.js 20 or newer are required.

Use cases

  • Investigate a file hash and its related infrastructure
  • Check URLs, IP addresses, or domains against VirusTotal
  • Search VirusTotal Intelligence using indicator filters
  • Review sandbox behavior for a file
  • Pivot through threat-actor and malware-family collections

Key features

  • VirusTotal v3 reports for files, URLs, IPs, and domains
  • Batched report relationships
  • Cursor-based relationship pagination
  • VTI-style corpus search
  • Merged file behavior summaries
  • stdio and HTTP streaming transports

Tools24

What MCP Virustotal lets your agent do. Expand a tool for its parameters.

Self-reported~72 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

15/15 checks healthy over the last 90d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · @burtthecoder/mcp-virustotal (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars155Stargazers on the source repository.
npm downloads4.6kPackage downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Tools exposed24Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Virustotal works

What BurtTheCoder/mcp-virustotal does

BurtTheCoder/mcp-virustotal exposes VirusTotal v3 API operations through the Model Context Protocol. Agents can look up file hashes, URLs, IP addresses, and domains, then inspect associated entities such as contacted hosts, dropped files, resolutions, threat actors, and other relationships.

The report tools combine the primary indicator report with selected relationships in a batched request. URL lookups use a cache-first flow: the server returns an existing VirusTotal report when available and submits the URL for scanning only after a cache miss.

Additional tools support VirusTotal Intelligence-style corpus searches, consolidated file-behavior summaries from sandbox results, and collection lookups for threat actors and malware families.

How it works

An MCP client communicates with the server over either standard input/output or HTTP streaming. The server validates tool arguments, sends HTTPS requests authenticated with the API key, and formats the returned JSON as report text for the agent.

The default transport is stdio, which suits local desktop and command-line clients. Setting the transport to httpStream starts a standalone HTTP service. That mode exposes the MCP endpoint and a /health check, making it suitable for a separately hosted service.

Relationship endpoints support cursor-based paging and cover files, URLs, IP addresses, and domains. The server is independent of VirusTotal and is not affiliated with VirusTotal or Google.

Setup and configuration

Use Node.js 20 or newer and provide a VirusTotal API key. The package can be launched through npm without a local checkout:

Terminal
claude mcp add --transport stdio --env VIRUSTOTAL_API_KEY=your-key virustotal -- npx -y @burtthecoder/mcp-virustotal

For source-based development, clone the repository, run npm ci, and use the project scripts. Unit tests run without an API key or network access; the smoke test calls the live API and requires a key.

The main environment variables are:

  • VIRUSTOTAL_API_KEY: required API credential.
  • MCP_TRANSPORT: stdio by default, or httpStream.
  • MCP_HOST: HTTP bind address, defaulting to localhost.
  • MCP_PORT: HTTP port, defaulting to 3000.
  • MCP_ENDPOINT: HTTP MCP path, defaulting to /mcp.

Tools and capabilities

The tool groups are:

  • Reports: get_file_report, get_url_report, get_ip_report, and get_domain_report.
  • Relationship paging: indicator-specific tools for files, URLs, IPs, and domains.
  • Search and pivot: search_vt, get_file_behaviour_summary, and get_collection.

Search accepts VTI-style modifiers such as type and detection-count filters. Relationship queries can retrieve more than the initial result page by using cursors. Report lookups are useful for starting an investigation, while behavior summaries and collections provide additional context for pivots.

Limitations and notes

The HTTP transport has no built-in authentication. Keep it bound to localhost or place it behind an authenticating reverse proxy; otherwise, reachable users could use the service and consume the configured VirusTotal quota.

VirusTotal receives the indicators used for lookups. A URL submitted after a cache miss is sent to VirusTotal for analysis. The public API tier allows four requests per minute, so relationship-heavy investigations and live smoke tests may need pacing. API-key changes require restarting the MCP client.

The project is licensed under MIT.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Virustotal

BurtTheCoder/mcp-virustotal is an MCP server that connects AI clients to the VirusTotal v3 API. Its main tools retrieve file, URL, IP, and domain reports, page through relationships, search VirusTotal, summarize file behavior, and inspect threat-intelligence collections using a supplied API key.

Install it by running the npm package through an MCP client and setting VIRUSTOTAL_API_KEY. For example, Claude Code can use `claude mcp add --transport stdio --env VIRUSTOTAL_API_KEY=your-key virustotal -- npx -y @burtthecoder/mcp-virustotal`. Node.js 20 or newer is required.

Yes, it supports standard MCP client connections over stdio, and it can also run through HTTP streaming. Configure Cursor as an MCP client with the server command and the required VIRUSTOTAL_API_KEY.

Set `MCP_TRANSPORT=httpStream`, provide `VIRUSTOTAL_API_KEY`, and start the built server. `MCP_PORT`, `MCP_HOST`, and `MCP_ENDPOINT` control the bind address, port, and MCP path. The HTTP mode has no authentication, so protect it with network controls or an authenticating reverse proxy.

It requires your own VirusTotal API key in `VIRUSTOTAL_API_KEY`. The key is sent to VirusTotal for API requests, while tool arguments are validated before requests are constructed. The public tier allows four requests per minute.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Virustotal AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/burtthecoder-mcp-virustotal?style=directory)](https://allmcps.com/mcp/burtthecoder-mcp-virustotal)
HTML Embed
<a href="https://allmcps.com/mcp/burtthecoder-mcp-virustotal"><img src="https://allmcps.com/api/badge/burtthecoder-mcp-virustotal?style=directory" alt="MCP Virustotal on AllMCPs" /></a>