# VirusTotal

> VirusTotal is a freemium MCP server for security. Threat reports on files, URLs, domains and IPs for MCP clients, via VirusTotal's VTAI. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://ai.virustotal.com/connect/mcp
- **Repository:** https://github.com/virustotal/virustotal-mcp
- **MCP Registry name:** io.github.VirusTotal/virustotal-mcp
- **Categories:** security
- **Listing updated:** 2026-11-15

## About

Access runs on free quotas rather than a personal VirusTotal API key: 60 queries per 60 seconds and 1,000 per UTC day for each Agent Token or OAuth account. Repeated lookups, cached reports and hashes with no report all count against that allowance. Uploading a new file uses no query quota but is capped at 20 per minute and 500 per day.

The server connects to the VTAI service and returns reports for files, URLs, domains and IP addresses. It also submits files and network analyses and can recover a submission receipt. When a file is submitted, the server first checks whether its hash is already known and only uploads confirmed unknown files.

Submissions are shared with the VirusTotal community and partners and are not confidential, so the site says files, URLs or reanalysis requests should only be sent when the user explicitly asks. You can connect remotely with OAuth at ai.virustotal.com/mcp, or run the vt-mcp Python package over stdio with a token file. A Claude Code plugin adds a threat-intelligence skill and local file uploads.

## Features

- **Multi-indicator reports:** Returns threat reports for files, URLs, domains and IP addresses.
- **Submission tools:** Submits files and URLs and can request network reanalysis.
- **Receipt recovery:** Recovers the outcome of an uncertain submission.
- **Hash check before upload:** Looks up a file's hash first and uploads only files confirmed unknown.
- **OAuth or token sign-in:** Connect remotely with a browser sign-in, or use an Agent Token file over stdio.
- **Claude Code plugin:** Plugin bundles the connection, a threat-intelligence skill and local uploads.

## Good for

- Check a link before an agent opens it
- Look up a downloaded file's hash before running it
- Investigate a suspicious IP address or domain
- Submit an unknown sample for analysis when explicitly requested

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http virustotal-mcp https://ai.virustotal.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://ai.virustotal.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "virustotal-mcp": {
      "url": "https://ai.virustotal.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "virustotal-mcp": {
      "type": "http",
      "url": "https://ai.virustotal.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "virustotal-mcp": {
      "serverUrl": "https://ai.virustotal.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "virustotal-mcp": {
      "type": "http",
      "url": "https://ai.virustotal.com/mcp"
    }
  }
}
```

## FAQ

### Do I need my own VirusTotal API key?

No. The README says the free VTAI service is used with its access limits and no personal API key is required.

### What are the free limits?

60 queries per 60 seconds and 1,000 per UTC day per Agent Token or OAuth account, plus 20 file uploads per minute and 500 per day.

### Are submissions private?

No. Submissions are shared with the VirusTotal community and partners and are not confidential.

### How do I connect it?

Use https://ai.virustotal.com/mcp with OAuth in a remote client, or install vt-mcp from PyPI and set VTAI_TOKEN_FILE for stdio.

### Is VirusTotal free?

VirusTotal has a free plan, with paid plans for more usage or features.

### How do I add VirusTotal to Claude Code?

Run this command in your terminal: claude mcp add --transport http virustotal-mcp https://ai.virustotal.com/mcp

### What are the best alternatives to VirusTotal?

The closest alternatives to VirusTotal are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/virustotal-4
