PluginBench
MCP Server

OSINT MCP MCP Server

io.github.rjn32s/osint-mcp

What is the OSINT MCP MCP server?

26 free OSINT tools as MCP tools for AI agents. Auto-installs everything on first run.

How to install OSINT MCP

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • SHODAN_KEY
    secret

    Optional: Shodan API key for host/port lookups. Free tier at https://account.shodan.io

  • VIRUSTOTAL_KEY
    secret

    Optional: VirusTotal API key for URL/IP/hash scanning. Free at https://virustotal.com

  • IPINFO_KEY
    secret

    Optional: ipinfo.io API key for IP geolocation. 50k req/month free.

  • HIBP_KEY
    secret

    Optional: HaveIBeenPwned API key for email breach lookups.

  • URLSCAN_KEY
    secret

    Optional: urlscan.io API key for URL scanning.

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "osint-mcp": {
      "command": "uvx",
      "args": [
        "osint-mcp"
      ],
      "env": {
        "SHODAN_KEY": "<YOUR_SHODAN_KEY>",
        "VIRUSTOTAL_KEY": "<YOUR_VIRUSTOTAL_KEY>",
        "IPINFO_KEY": "<YOUR_IPINFO_KEY>",
        "HIBP_KEY": "<YOUR_HIBP_KEY>",
        "URLSCAN_KEY": "<YOUR_URLSCAN_KEY>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "osint-mcp": {
      "command": "uvx",
      "args": [
        "osint-mcp"
      ],
      "env": {
        "SHODAN_KEY": "<YOUR_SHODAN_KEY>",
        "VIRUSTOTAL_KEY": "<YOUR_VIRUSTOTAL_KEY>",
        "IPINFO_KEY": "<YOUR_IPINFO_KEY>",
        "HIBP_KEY": "<YOUR_HIBP_KEY>",
        "URLSCAN_KEY": "<YOUR_URLSCAN_KEY>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "osint-mcp": {
      "command": "uvx",
      "args": [
        "osint-mcp"
      ],
      "env": {
        "SHODAN_KEY": "<YOUR_SHODAN_KEY>",
        "VIRUSTOTAL_KEY": "<YOUR_VIRUSTOTAL_KEY>",
        "IPINFO_KEY": "<YOUR_IPINFO_KEY>",
        "HIBP_KEY": "<YOUR_HIBP_KEY>",
        "URLSCAN_KEY": "<YOUR_URLSCAN_KEY>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "osint-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "osint-mcp"
      ],
      "env": {
        "SHODAN_KEY": "<YOUR_SHODAN_KEY>",
        "VIRUSTOTAL_KEY": "<YOUR_VIRUSTOTAL_KEY>",
        "IPINFO_KEY": "<YOUR_IPINFO_KEY>",
        "HIBP_KEY": "<YOUR_HIBP_KEY>",
        "URLSCAN_KEY": "<YOUR_URLSCAN_KEY>"
      }
    }
  }
}
Claude Code
claude mcp add osint-mcp --env SHODAN_KEY=<YOUR_SHODAN_KEY> --env VIRUSTOTAL_KEY=<YOUR_VIRUSTOTAL_KEY> --env IPINFO_KEY=<YOUR_IPINFO_KEY> --env HIBP_KEY=<YOUR_HIBP_KEY> --env URLSCAN_KEY=<YOUR_URLSCAN_KEY> -- uvx osint-mcp

Related MCP servers

An MCP server providing zero-shot object detection and segmentation using Ultralytics YOLOE.

View repository →