frishtik/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:
bash
git clone https://github.com/frishtik/osint-tools-mcp-server.git
cd osint-tools-mcp-server
2. Install dependencies:
bash
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):
json
"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
bash
git clone https://github.com/smicallef/spiderfoot.git /opt/spiderfoot
cd /opt/spiderfoot
pip install -r requirements.txt
#### GHunt
bash
git clone https://github.com/mxrch/GHunt.git /opt/ghunt
cd /opt/ghunt
pip install -r requirements.txt
#### Blackbird
bash
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