# Choose your VirusTotal connection

Choose your client to see its setup instructions.

- [Antigravity CLI (agy)](/connect/mcp?client=agy&format=markdown)
- [Claude Code](/connect/mcp?client=claude&format=markdown)
- [Codex](/connect/mcp?client=codex&format=markdown)
- [Cursor](/connect/mcp?client=cursor&format=markdown)
- [VS Code](/connect/mcp?client=vscode&format=markdown)
- [GitHub Copilot CLI](/connect/mcp?client=copilot&format=markdown)
- [Devin Local / CLI](/connect/mcp?client=devin&format=markdown)
- [Cascade / Windsurf](/connect/mcp?client=cascade&format=markdown)
- [Claude / Claude Desktop](/connect/mcp?client=claude-web&format=markdown)
- [ChatGPT](/connect/mcp?client=chatgpt&format=markdown)
- [Gemini Apps](/connect/mcp?client=gemini&format=markdown)
- [Gemini CLI](/connect/mcp?client=gemini-cli&format=markdown)
- [Another MCP client](/connect/mcp?client=other&format=markdown)

For headless agents or a result in this session, use [REST](/skills/BASIC.md). Reuse an Agent Token; no MCP installation is required.

Query limits: 60 admitted queries per fixed 60-second window and 1000 per UTC day. Agent Tokens share the agent's allowance across REST and MCP; OAuth connections share the account's allowance. Unknown reports and upstream failures after admission count. Every repeated lookup counts again, including cached reports and hashes with no report. On 429, honor Retry-After and reuse your credential. File submissions first check whether the hash exists in VirusTotal. Only confirmed unknown files are uploaded, without using query quota, even when the query allowance is exhausted. A separate file contribution limit permits 20 admitted upload attempts per fixed 60-second window and 500 per UTC day, per Agent Token identity or OAuth account across connections. Failed or uncertain admitted attempts still count; known files and receipt recovery do not. Creating multiple identities or accounts to evade limits is not permitted. If the file is known, returning its existing report costs one query and no file is uploaded. Explicit hash lookups and analysis-result reads still count. The access check costs no query quota and does not report remaining quota.

Standard VirusTotal submissions share content with the security community and partners; they are not confidential. Upload files or attachments, submit URLs, or request domain/IP reanalysis only when the user explicitly requests that action. A missing report, an unfamiliar file or a suspicious indicator is not permission to submit it. Explain the sharing and ask before submitting the user's own documents, internal code, credentials or personal data. Submission tools add no per-call confirmation; client permissions still apply.