Skip to content
MCP server

VirusTotal

Threat reports on files, URLs, domains and IPs for MCP clients, via VirusTotal's VTAI

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.9.9
Listing updated
2 days ago

About VirusTotal

VirusTotal is a freemium MCP server for security. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://ai.virustotal.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "virustotal-mcp": {
      "url": "https://ai.virustotal.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • VTAI_TOKEN_FILEPath to a protected file containing only your VTAI token. Get free access at https://ai.virustotal.com/connect/mcp.Required

What it does

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

Pricing

Freemium

Free quota: 60 queries/minute, 1,000/day; higher limits not described

Prices change. Check ai.virustotal.com before you buy.

VirusTotal 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 to VirusTotal

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security