MCP serverPartly tested (needs an account)
Check links and files with VirusTotal
VirusTotal MCP
Official VirusTotal connector: your assistant can look up a link, domain, IP or file hash and tell you what security scanners said before you open it.
- Works with
- Claude Code, Codex CLI, Gemini CLI
- Good for
- Security testing, Everyone
What it does
VirusTotal is a service that checks files and web addresses against many security scanners and threat feeds. This is VirusTotal's own connector (an MCP server, a bridge that gives your assistant extra tools). With it, you can ask "is this link safe to open?" in plain words and get the answer in your session.
Your assistant can read existing reports for a web address, a domain, an IP address or a file. For a file, it looks up the file's fingerprint, called a hash. It then explains the report in plain words. If you ask for it, the assistant can also send a file or a link for a new scan.
The connector uses the VTAI service. The README says you can use it free within its current limits, and you do not need your own VirusTotal API key. You sign in through your browser. The limits are 60 report lookups per minute and 1000 per day. Every lookup counts, also a repeat and also a lookup that finds no report.
Two facts matter before you upload anything:
- Normal VirusTotal submissions are shared with the security community and partners. They are not private. Never upload your own documents, contracts, code or anything with personal data.
- A missing report means "unknown". Zero detections do not prove that a file or link is safe.
In Claude Code, the official plugin adds a threat-intelligence skill and a hook. A hook is a small helper that runs at a fixed point in Claude's work. This hook lets Claude upload a file from your project without copying the whole file through the chat. It adds no extra question for each file. Once you allow the upload tool, the upload goes through. The hook reads only files in your current working folder, plus folders that you list in VTAI_UPLOAD_ROOTS. It blocks file names that often hold passwords or keys, and it refuses files over 24,000,000 bytes.
Who it is for
People who want a quick second opinion on a suspicious file, link, domain or IP address, asked in plain words, without a paid VirusTotal API key.
Example prompts
- "Use VirusTotal to get the domain report for virustotal.com. Show the source, analysis date, coverage and report link."
- "/virustotal:threat-intelligence Is the domain in this email safe to visit?"
- "Look up this SHA-256 hash on VirusTotal and explain the result in simple words."
- "What does VirusTotal know about this IP address that keeps appearing in my server log?"
How to install
claude plugin marketplace add VirusTotal/virustotal-mcpclaude plugin install virustotal@virustotalgemini extensions install https://github.com/VirusTotal/virustotal-mcp --ref mainHow to use it
Ask: Use VirusTotal to get the domain report for example.com and show the analysis date and report link. Then sign in when /mcp asks you to.
Other assistants
Codex CLI, with browser sign-in:
- Add the server:
codex mcp add virustotal --url https://ai.virustotal.com/mcp- Sign in:
codex mcp login virustotal- Complete the browser sign-in, then open a new Codex session. VirusTotal says it checked this sign-in with Codex in a test setup, not in a full real-world run.
Gemini CLI:
- Make sure Git is installed.
- Install the extension:
gemini extensions install https://github.com/VirusTotal/virustotal-mcp --ref main- Accept the source-trust prompt after you read the repository.
- Check the install:
gemini extensions listThe Gemini extension asks for permission to submit files and links, not only to read reports.
Check it works
- The plugin needs Claude Code 2.1.283 or newer and Node.js 22 or newer.
- Start a new session, or run
/reload-plugins. - Run
/mcpand complete the browser sign-in forvirustotal. - Ask for the domain report for virustotal.com. You should see an analysis date and a report link.
No Node.js? Use the direct connection for lookups only: claude mcp add --transport http virustotal https://ai.virustotal.com/mcp. Use the plugin or this connection, not both.
Common problems
- No tools after install — the plugin is installed but no VirusTotal tools appear — start a new session or run
/reload-plugins, then run/mcpand sign in. Do not add a second manual connection. - Plugin does not run — an older Claude Code or Node.js — update to Claude Code 2.1.283 and Node.js 22, or use the direct
claude mcp addline above. - Upload blocked by file name — the hook stops and asks for review — the name looks like a key or password file. Do not rename the file to get past the block.
- Uploads stop for a while —
contribution_limited— this is an HTTP 429 error. Wait for the retry time in the message. The upload limit is 20 new files per minute and 500 per day.
What to watch out for
- Needs a VTAI account and a browser sign-in (OAuth); every report lookup counts against that account's quota, also repeated ones
- Files or links you choose to submit are shared with the security community and partners; they are not confidential (README)
- The Claude Code plugin has a hook that reads files in your working folder and can approve a file upload without asking you again
- Do not ask it to upload your own documents or code: uploads are shared and are not confidential
- A link lookup sends the full link to VirusTotal; do not check links that hold private tokens
- The Gemini CLI extension asks for permission to submit files and links, not only to read reports
- The Claude Code plugin needs Claude Code 2.1.283+ and Node.js 22+; the manual HTTP line needs neither
- Zero detections do not prove a file or link is safe (README)
- Report lookups are limited to 60 per minute and 1000 per day; new-file uploads to 20 per minute and 500 per day
- Removing the plugin does not cancel the sign-in; revoke access under Your connections on the VTAI site (README)
Licence and author
- Licence
- Apache-2.0
- Author
- VirusTotal
- Source code
- github.com/VirusTotal/virustotal-mcp
How we tested it
We installed it on an empty test computer on 15 Oct 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.
The hosted server answered and asked for a sign-in, as expected. We did not sign in or look up a report, because that needs a VTAI account. Not run: the Gemini CLI line. Not yet used on real work.
Technical details of the test
- Date
- 15 Oct 2026
- Method
- Intake sandbox run on 2026-10-15 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed virustotal@virustotal with the Claude Code command line.
Checked again on 16 Oct 2026
Alternatives
- Snyk Agent Scan — checks the agents and MCP servers on your own computer, not files and links you received.
- geiger — lists the AI tools installed on your computer; it does no online lookups.
FAQ
Do I need to pay? No API key is needed. The README says you can use the free VTAI service within its current limits.
Does a link check upload my files?
No. A report lookup reads an existing report. It sends the full link, including any part after ? or #, so do not check links that hold private tokens.
Will the Gemini extension work with my Google login? Maybe not. Since June 18, 2026, Gemini CLI no longer accepts Login with Google for the individual, Google AI Pro and Google AI Ultra tiers.
How do I remove it?
Run claude plugin disable virustotal@virustotal or claude plugin uninstall virustotal@virustotal. Removing it does not cancel the sign-in. To cancel access, use "Your connections" on the VTAI site.
Sources
- github.com/VirusTotal/virustotal-mcp
- raw.githubusercontent.com/VirusTotal/virustotal-mcp/main/docs/google-clients.md
- raw.githubusercontent.com/VirusTotal/virustotal-mcp/main/docs/claude-code.md
- raw.githubusercontent.com/VirusTotal/virustotal-mcp/main/README.md
- raw.githubusercontent.com/VirusTotal/virustotal-mcp/main/docs/analysis.md
- raw.githubusercontent.com/VirusTotal/virustotal-mcp/main/plugins/claude-code/hooks/hooks.json
- raw.githubusercontent.com/VirusTotal/virustotal-mcp/main/gemini-extension.json
- ai.virustotal.com/connect/mcp?client=codex&transport=http
- learn.chatgpt.com/docs/extend/mcp
- developers.google.com/gemini-code-assist/docs/deprecations/code-assist-individuals