virustotal-mcp
Official VirusTotal MCP server for AI agents: threat intelligence, file analysis, and recovery through VTAI.
Install / Use
claude mcp add VirusTotal -- npx -y github:VirusTotal/virustotal-mcpIf the server publishes to npm under a different name, use that package instead โ check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
SecuritySupported Platforms
Our assessment of virustotal-mcp
virustotal-mcp scores 76/100 on our quality scale, 1014th of 1,097 Security skills we index.
Its MCP Server is 23 KB long, well organised into 12 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.
It has 43 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 4 days ago, so virustotal-mcp is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit โ read the skill file before letting an agent act on it.
virustotal-mcp compared with similar skills
All 4 of these similar skills score higher than virustotal-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| virustotal-mcp (this skill)by VirusTotal | 76 | 43 | 4d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 87.1k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.1k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.2k | today | CLAUDE.md |
Frequently asked questions
- How do I install virustotal-mcp?
- Run
claude mcp add VirusTotal -- npx -y github:VirusTotal/virustotal-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does virustotal-mcp work with?
- It is written for Claude Code, Claude Desktop and Gemini CLI, as a MCP Server file. Other agents that read the same format can often use it too.
- Is virustotal-mcp safe to use?
- It is Apache-2.0-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is virustotal-mcp still maintained?
- The repository was last updated 4 days ago, so virustotal-mcp is actively maintained.
Skill content
View source on GitHubVirusTotal MCP
<!-- mcp-name: io.github.VirusTotal/virustotal-mcp -->The official VirusTotal MCP server gives your agent threat intelligence before it opens a link, runs a downloaded file or investigates suspicious infrastructure. vt-mcp connects MCP clients to VTAI, with reports for files, URLs, domains and IP addresses, file and network analysis submission, and receipt recovery.
Use the free VTAI service with its current access limits. You do not need your own VirusTotal API key.
Connect remotely with OAuth
Use https://ai.virustotal.com/mcp in a compatible remote MCP client. Sign in
with your VTAI account and approve the connection's permissions; no local Python
installation, static token or personal VirusTotal API key is required.
Claude Code: install the plugin
The official plugin includes the OAuth connection, a threat-intelligence skill and existing reports for file hashes, URLs, domains and IP addresses. It includes no hooks or bundled scripts; local files are checked by hash.
<!-- client-contract:claude-code:start -->claude plugin marketplace add VirusTotal/virustotal-mcp
claude plugin install virustotal@virustotal
Requires Claude Code 2.1.283 or later. The plugin needs no separate Node.js installation and runs no hooks or bundled scripts. The plugin includes https://ai.virustotal.com/mcp.
If you are replacing an existing manual connection with the plugin, read the migration and recovery guide before removing anything. Recover uncertain submissions through the original connection first; keep a working manual connection if you choose that alternative.
Start a new session or use /reload-plugins, then /mcp to complete browser
sign-in when needed. The plugin already supplies the MCP connection; do not add
a duplicate. See plugin setup, file checks and submission options.
Claude Code alternative: manual HTTP without Node.js
For the remote connection without the plugin skill, use:
claude mcp add --transport http virustotal https://ai.virustotal.com/mcp
Open Claude Code, run /mcp, select virustotal and complete browser sign-in.
See the Claude Code OAuth instructions
and the VirusTotal connection guide.
Choose this alternative or the plugin. Adding a server configures it; complete authentication and a tool call to check
that your connection works.
OAuth connections share the signed-in VTAI account's free quota and use the
permissions approved for each connection. Existing Agent Tokens keep their rights
and quotas. If your client needs configurable HTTP headers, use one protected
Authorization: Bearer or x-apikey credential instead of OAuth. Other local
clients can use the stdio installation below.
Connect your client
- For compatible remote clients, connect with OAuth using the MCP URL. Otherwise, reuse your existing VTAI Agent Token or create one.
- For stdio, save the token in a file readable only by your user, such as
~/.config/vt-mcp/token. Set the MCP server's environment variableVTAI_TOKEN_FILEto that path and its command tovt-mcp. The file contains only the token; never put the token itself in chat, command arguments or project files. - Follow the client-specific setup, restart or reconnect the client, and inspect its available tools.
| Client | Setup |
|---|---|
| Antigravity CLI (agy) | Marketplace plugin with MCP and skill, local stdio or native OAuth recipe |
| Claude Code | OAuth plugin with threat-intelligence skill, HTTP or local stdio |
| Codex | HTTP or local stdio |
| ChatGPT | Install the published VirusTotal plugin ยท Connection guide |
| Cursor | HTTP recipe |
| VS Code with GitHub Copilot | HTTP recipe |
| GitHub Copilot CLI | HTTP OAuth recipe or local stdio |
| Devin CLI | HTTP OAuth recipe or local stdio |
| Windsurf / Devin Desktop | Cascade HTTP recipe |
| Antigravity IDE | Local stdio configuration or native OAuth recipe |
| Gemini CLI | Install the OAuth extension |
| Gemini Apps | Custom MCP connection and optional importable skill, subject to Google's account and regional availability; complete hosted workflow validation pending |
| Grok Build | Manual plugin installation; OAuth, reports and renewal verified |
| Kimi Code | Manual plugin installation; OAuth, reports and proactive renewal verified with an external model |
Remote OAuth configuration for GitHub Copilot CLI and Devin CLI follows their official documentation; an OAuth-authenticated VirusTotal tool workflow has not yet been verified in either client.
See additional remote client recipes for Qwen Code, Mistral Vibe Work, Grok web and the xAI Responses API, with their validation limits. Qwen Code 0.25.1 has a known OAuth credential-storage incompatibility with VTAI; browser consent alone does not complete its connection.
The client validation guide distinguishes documented configuration, local transport checks and workflows exercised with a model. A recipe is not a claim of full validation in every client. Other agents can use the same MCP endpoint or the VTAI API directly.
In ChatGPT, install the published VirusTotal plugin, connect with Google when prompted, then select @VirusTotal in a new chat. Developer mode is not required for the published plugin; account and workspace policies still apply. The connection guide includes the separate custom-app alternative and validation limits. Initial OAuth consent, IP reports and automatic token renewal were verified separately on 2026-09-24; publication does not validate every workflow.
For a first query, ask your agent:
Use VirusTotal to get the domain report for virustotal.com. Show the source, analysis date, coverage and report link.
In ChatGPT, prefix the prompt with @VirusTotal. A report lookup does not read or upload local files. A missing report remains unknown, and zero detections do not establish safety.
Install for local stdio
For local stdio, install uv and run:
uv tool install --python 3.12 --default-index https://pypi.org/simple 'vt-mcp==0.9.9'
vt-mcp --version
The local MCP server supports Linux, macOS and Windows, including both file submission tools. Windows submission receipts require local NTFS storage; network shares and reparse points are rejected. The separate vt-mcp guard command remains Linux-only.
For automatic client configuration, choose Agy, Claude Code or Codex in the setup guide, then open its Agent Token alternative and choose your operating system. The installer protects the token using owner-only POSIX permissions or a Windows user-only ACL.
The command installs the package from the official PyPI index in an isolated tool environment. Python 3.12 or newer is required. Keep vt-mcp on the MCP client's PATH, or use its absolute executable path. The package does not modify client configuration.
Maintain an existing connection
Open your client's Agent Token alternative in the setup guide to check the configured transport and update a setup-managed installation without creating another token. The access check uses GET /api/v3/agents/me/access without query cost; a real report query consumes quota. Restart the client after an update. An access or configuration check does not exercise a tool or certify the model's behavior.
If your client runs a manually installed vt-mcp executable, upgrade that environment:
uv tool install --upgrade --python 3.12 --default-index https://pypi.org/simple 'vt-mcp==0.9.9'
vt-mcp --version
A client configured with uvx ... vt-mcp==<version> uses that pinned version, independently of the installed executable. Update its pin or use the setup guide. Hosted HTTP connections use the deployed server; they do not need a local package upgrade. Keep existing tokens and submission receipts.
Missing-report, quota and temporary-service errors include next_steps and a documentation link. A missing report leaves the file or indicator unknown; verify its hash or value. Report lookups never authorize a submission or reanalysis. Use submission tools only when the user explicitly requests that action, under the sharing guidance below. Retain the file's SHA256 or a new UUIDv4 request_id for an intended network operation, then recover using that identifier. On quota or temporary service failures, honor retry_after_seconds when present, retain credentials and avoid tight retry loops. Never automatically replay an uncertain submission or replace its request ID: recover its receipt first.
Antigravity IDE
In the agent panel, open MCP Servers โ Manage MCP Servers โ View raw config and merge this entry with your existing configuration:
{
"mcpServers": {
"virustotal": {
"command": "vt-mcp",
"args": [],
"env": {
"VTAI_TOKEN_FILE": "~/.c
Truncated for display โ read the full file on GitHub.
Related Skills
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu โ one CLI, zero API fees.
hyperframes
87.1kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.1k๐ The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.2kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit โ see the Safety scan above for what the skill file itself contains.
