🔍 OSINT Tools MCP Server

A comprehensive MCP server that exposes multiple OSINT tools to AI assistants like Claude. This server allows AI to perform sophisticated reconnaissance and information gathering tasks using industry-standard OSINT tools.

🛠️ Available Tools

🔍 Sherlock - Username Search

Search for usernames across 399+ social media platforms and websites. Perfect for digital footprint analysis.

• Input: Username
• Output: List of platforms where username exists

📧 Holehe - Email Verification

Check if an email is registered on 120+ platforms. Lightning fast and accurate.

• Input: Email address
• Output: Platforms where email is registered

🕷️ SpiderFoot - Comprehensive OSINT

The Swiss Army knife of OSINT. Performs deep reconnaissance with automatic target type detection.

• Input: IP, domain, email, phone, username, person name, Bitcoin address, or network block
• Output: Comprehensive intelligence report
• ⚠️ Note: SpiderFoot can take 5-30 minutes to complete a full scan. Be patient!

🔎 GHunt - Google Account Intel

Extract information from Google accounts using email or Google ID.

• Input: Email or Google ID
• Output: Google account details and associated information

🌐 Maigret - Advanced Username Search

Search across 3000+ sites with false positive detection and detailed analysis.

• Input: Username
• Output: Detailed report with confidence scores

🌾 TheHarvester - Domain Intelligence

Gather emails, subdomains, hosts, employee names, and more from public sources.

• Input: Domain or company name
• Output: Comprehensive domain intelligence

🐦 Blackbird - Fast Username OSINT

Lightning-fast searches across 581 sites for username reconnaissance.

• Input: Username
• Output: Quick profile discovery results

🚀 Installation

MCP Server Setup

1. Clone this repository:

git clone https://github.com/frishtik/osint-tools-mcp-server.git
cd osint-tools-mcp-server

2. Install dependencies:

pip install -r requirements.txt

This will automatically install Sherlock, Holehe, Maigret, and TheHarvester.

3. Configure Claude Desktop:

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "osint-tools": {
      "command": "python",
      "args": ["/path/to/osint-tools-mcp-server/src/osint_tools_mcp_server.py"],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

4. Restart Claude Desktop to load the new MCP server.

Prerequisites for Additional Tools

Some tools require manual installation due to their complexity:

SpiderFoot

git clone https://github.com/smicallef/spiderfoot.git /opt/spiderfoot
cd /opt/spiderfoot
pip install -r requirements.txt

GHunt

git clone https://github.com/mxrch/GHunt.git /opt/ghunt
cd /opt/ghunt
pip install -r requirements.txt

Blackbird

git clone https://github.com/p1ngul1n0/blackbird.git /opt/blackbird
cd /opt/blackbird
pip install -r requirements.txt

🎮 Usage Tips

Getting Started

Working with AI for OSINT is a bit of an art form. Here's how to get the best results:

Start Simple with Holehe

I recommend starting with the Holehe tool - it's fast, reliable, and gives you immediate results:

"Check if john.doe@example.com is registered on any platforms"

Level Up to Username Searches

Once you're comfortable, try username searches with Sherlock

... View full README on GitHub