Skip to content
Back to search

osint-tools-mcp-server

MCP server exposing multiple OSINT tools for AI assistants like Claude

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/frishtik--osint-tools-mcp-server/badge.svg)](/listings/frishtik--osint-tools-mcp-server)

HTML

<a href="/listings/frishtik--osint-tools-mcp-server"><img src="/api/listings/frishtik--osint-tools-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 237 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🔍 OSINT Tools MCP Server
  2. [![MCP Server](https://img.shields.io/badge/MCP-Server-blue)](https://github.com/modelcontextprotocol/specification)
  3. [![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
  4. [![Python](https://img.shields.io/badge/Python-3.8%2B-blue)](https://www.python.org/)
  5. [![OSINT](https://img.shields.io/badge/OSINT-Tools-red)](https://github.com/topics/osint)
  6. 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.
  7. ## 🛠️ Available Tools
  8. ### 🔍 **Sherlock** - Username Search
  9. Search for usernames across 399+ social media platforms and websites. Perfect for digital footprint analysis.
  10. - **Input**: Username
  11. - **Output**: List of platforms where username exists
  12. ### 📧 **Holehe** - Email Verification
  13. Check if an email is registered on 120+ platforms. Lightning fast and accurate.
  14. - **Input**: Email address
  15. - **Output**: Platforms where email is registered
  16. ### 🕷️ **SpiderFoot** - Comprehensive OSINT
  17. The Swiss Army knife of OSINT. Performs deep reconnaissance with automatic target type detection.
  18. - **Input**: IP, domain, email, phone, username, person name, Bitcoin address, or network block
  19. - **Output**: Comprehensive intelligence report
  20. - **⚠️ Note**: SpiderFoot can take 5-30 minutes to complete a full scan. Be patient!
  21. ### 🔎 **GHunt** - Google Account Intel
  22. Extract information from Google accounts using email or Google ID.
  23. - **Input**: Email or Google ID
  24. - **Output**: Google account details and associated information
  25. ### 🌐 **Maigret** - Advanced Username Search
  26. Search across 3000+ sites with false positive detection and detailed analysis.
  27. - **Input**: Username
  28. - **Output**: Detailed report with confidence scores
  29. ### 🌾 **TheHarvester** - Domain Intelligence
  30. Gather emails, subdomains, hosts, employee names, and more from public sources.
  31. - **Input**: Domain or company name
  32. - **Output**: Comprehensive domain intelligence
  33. ### 🐦 **Blackbird** - Fast Username OSINT
  34. Lightning-fast searches across 581 sites for username reconnaissance.
  35. - **Input**: Username
  36. - **Output**: Quick profile discovery results
  37. ## 🚀 Installation
  38. ### MCP Server Setup
  39. 1. **Clone this repository:**
  40. ```bash
  41. git clone https://github.com/frishtik/osint-tools-mcp-server.git
  42. cd osint-tools-mcp-server
  43. ```
  44. 2. **Install dependencies:**
  45. ```bash
  46. pip install -r requirements.txt
  47. ```
  48. This will automatically install Sherlock, Holehe, Maigret, and TheHarvester.
  49. 3. **Configure Claude Desktop:**
  50. Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
  51. ```json
  52. {
  53. "mcpServers": {
  54. "osint-tools": {
  55. "command": "python",
  56. "args": ["/path/to/osint-tools-mcp-server/src/osint_tools_mcp_server.py"],
  57. "env": {
  58. "PYTHONUNBUFFERED": "1"
  59. }
  60. }
  61. }
  62. }
  63. ```
  64. 4. **Restart Claude Desktop** to load the new MCP server.
  65. ### Prerequisites for Additional Tools
  66. Some tools require manual installation due to their complexity:
  67. #### SpiderFoot
  68. ```bash
  69. git clone https://github.com/smicallef/spiderfoot.git /opt/spiderfoot
  70. cd /opt/spiderfoot
  71. pip install -r requirements.txt
  72. ```
  73. #### GHunt
  74. ```bash
  75. git clone https://github.com/mxrch/GHunt.git /opt/ghunt
  76. cd /opt/ghunt
  77. pip install -r requirements.txt
  78. ```
  79. #### Blackbird
  80. ```bash
  81. git clone https://github.com/p1ngul1n0/blackbird.git /opt/blackbird
  82. cd /opt/blackbird
  83. pip install -r requirements.txt
  84. ```
  85. ## 🎮 Usage Tips
  86. ### Getting Started
  87. Working with AI for OSINT is a bit of an art form. Here's how to get the best results:
  88. #### Start Simple with Holehe
  89. I recommend starting with the **Holehe** tool - it's fast, reliable, and gives you immediate results:
  90. ```
  91. "Check if john.doe@example.com is registered on any platforms"
  92. ```
  93. #### Level Up to Username Searches
  94. Once you're comfortable, try username searches with Sherlock or Maigret:
  95. ```
  96. "Search for the username 'johndoe123' across social media platforms"
  97. ```
  98. #### Complex Orchestrations
  99. Here's where it gets interesting. You can chain tools together:
  100. ```
  101. "I found an email address contact@suspicious-site.com. Can you:
  102. 1. Check what platforms it's registered on
  103. 2. Extract the domain and search for subdomains and other emails
  104. 3. Search for any usernames associated with this domain"
  105. ```
  106. #### Let the AI Be Smart
  107. Sometimes the best approach is to give Claude context and let it decide:
  108. ```
  109. "I'm investigating the digital footprint of username 'hackerman2024'.
  110. Use your judgment to gather as much information as possible."
  111. ```
  112. ### Pro Tips 🎯
  113. 1. **Be Patient with SpiderFoot**: It's incredibly thorough but can take up to 30 minutes for a full scan. Start it and grab a coffee!
  114. 2. **Parallel Processing**: Claude can run multiple tools simultaneously. Don't hesitate to ask for parallel searches:
  115. ```
  116. "Search for 'johndoe' on both Sherlock and Maigret at the same time"
  117. ```
  118. 3. **Know When to Hold the Leash**:
  119. - For specific investigations: Be explicit about which tools to use
  120. - For exploratory research: Let Claude choose the tools
  121. - For time-sensitive tasks: Avoid SpiderFoot, stick to faster tools
  122. 4. **Cross-Reference Results**: Different tools have different databases. Maigret might find accounts that Sherlock misses and vice versa.
  123. 5. **Email First, Username Second**: If you have an email, start there - it's usually more unique than usernames.
  124. ## ⚖️ Ethical Usage & Legal Compliance
  125. **🚨 IMPORTANT: This tool is for legitimate security research and OSINT investigations only.**
  126. ### You MUST:
  127. - ✅ Only gather publicly available information
  128. - ✅ Respect privacy laws in your jurisdiction (GDPR, CCPA, etc.)
  129. - ✅ Follow platforms' Terms of Service
  130. - ✅ Use findings responsibly and ethically
  131. - ✅ Obtain proper authorization for any professional investigations
  132. ### You MUST NOT:
  133. - ❌ Use this for stalking, harassment, or any malicious purpose
  134. - ❌ Violate any local, state, or federal laws
  135. - ❌ Access private or protected information
  136. - ❌ Use findings to harm individuals or organizations
  137. ## 🔧 Troubleshooting
  138. ### Common Issues
  139. **Tools not found**: Make sure all OSINT tools are installed and in your PATH:
  140. ```bash
  141. which sherlock holehe maigret theharvester
  142. ```
  143. **SpiderFoot errors**: Ensure SpiderFoot is installed in `/opt/spiderfoot` or update the path in the code.
  144. **Timeout issues**: Some tools may timeout on slow connections. Try increasing the timeout parameter:
  145. ```
  146. "Search for username with a 30 second timeout"
  147. ```
  148. **Rate limiting**: Some platforms rate-limit searches. If you're getting blocked, wait a bit and try again.
  149. ## 🏗️ Architecture
  150. This MCP server uses Python's asyncio for non-blocking tool execution. Each tool runs in a subprocess, allowing for parallel execution and proper timeout handling.
  151. ```
  152. Claude Desktop <-> MCP Protocol <-> OSINT MCP Server <-> OSINT Tools
  153. ```
  154. ## 🤝 Contributing
  155. Found a bug? Want to add a new tool? Contributions are welcome!
  156. 1. Fork the repository
  157. 2. Create your feature branch (`git checkout -b feature/NewOSINTTool`)
  158. 3. Commit your changes (`git commit -m 'Add NewOSINTTool support'`)
  159. 4. Push to the branch (`git push origin feature/NewOSINTTool`)
  160. 5. Open a Pull Request
  161. ## 📚 Acknowledgments
  162. Special thanks to these awesome projects:
  163. - [mcp-maigret](https://github.com/BurtTheCoder/mcp-maigret) - Inspiration for MCP implementation and README structure. Go give them a ⭐!
  164. - [Model Context Protocol](https://github.com/modelcontextprotocol/specification) - The protocol making all this possible
  165. - All the incredible OSINT tool maintainers
  166. ## 📜 License
  167. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  168. ## ⚠️ Disclaimer
  169. This tool is provided for educational and legitimate security research purposes only. The authors are not responsible for any misuse or damage caused by this program. Use at your own risk and always ensure you have proper authorization before conducting any investigations.
  170. ---
  171. **Remember**: With great power comes great responsibility. Use these tools wisely and ethically! 🦸‍♂️
  172. Built with ❤️ for the OSINT community

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.