OSINT Tools

v1.0.0Securitystable

MCP server exposing multiple OSINT tools for AI assistants like Claude

aiclaudeholeheintelligence-gatheringinvestigation
Share:
204
Stars
0
Downloads
0
Weekly
0/5

What is OSINT Tools?

OSINT Tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server exposing multiple osint tools for ai assistants like claude

MCP server exposing multiple OSINT tools for AI assistants like Claude

This server falls under the Security and Search & Data Extraction categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server exposing multiple OSINT tools for AI assistants l

Use Cases

Intelligence gathering and investigation
OSINT reconnaissance
Email and data discovery
frishtik

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 13, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx osint-tools

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use OSINT Tools

The OSINT Tools MCP server is a Python-based MCP server that wraps seven popular open-source intelligence tools — Sherlock, Holehe, SpiderFoot, GHunt, Maigret, TheHarvester, and Blackbird — and exposes them as callable tools to AI assistants like Claude. It enables investigators, security researchers, and red teamers to run username lookups across thousands of social media platforms, verify email addresses across hundreds of services, and perform deep reconnaissance on domains, IPs, and individuals entirely through natural language queries. Each underlying tool must be installed separately on the host system.

Prerequisites

  • Python 3.9+ installed
  • pip for installing Python dependencies
  • The underlying OSINT tools installed: Sherlock (pip install sherlock-project), Holehe (pip install holehe), Maigret (pip install maigret), TheHarvester (pip install theHarvester); SpiderFoot, GHunt, and Blackbird cloned to /opt/
  • Claude Desktop or another MCP client
  • Only use this tool on accounts and data you have legal authorisation to investigate
1

Clone the MCP server repository

Clone the osint-tools-mcp-server repository and install its Python dependencies.

git clone https://github.com/frishtik/osint-tools-mcp-server.git
cd osint-tools-mcp-server
pip install -r requirements.txt
2

Install the underlying OSINT tools

The MCP server shells out to each OSINT tool, so they must be installed and reachable. Install the pip-based tools globally and clone the others to /opt/.

pip install sherlock-project holehe maigret theHarvester

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

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

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

Configure Claude Desktop

Edit claude_desktop_config.json to register the MCP server, pointing to the absolute path of the server Python script.

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

Restart Claude Desktop

Restart Claude Desktop so it picks up the new MCP server configuration. The server will be launched as a subprocess when Claude starts.

5

Run a test OSINT query

Ask Claude to check a username on social platforms using Sherlock to confirm the integration works.

OSINT Tools Examples

Client configuration

claude_desktop_config.json entry for the OSINT Tools MCP server pointing to the local Python script.

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

Prompts to try

Example investigation prompts using the seven exposed OSINT tools.

- "Search for the username 'johndoe123' across social media platforms using Sherlock."
- "Check if [email protected] is registered on any platforms using Holehe."
- "Run a Maigret search for 'alice_smith' and show confidence scores."
- "Use TheHarvester to gather emails and subdomains for example.com."
- "Run both Sherlock and Blackbird for username 'testuser' at the same time."

Troubleshooting OSINT Tools

Tool call fails with 'command not found' for sherlock, holehe, or maigret

The MCP server runs OSINT tools as subprocesses and needs them in the system PATH. Install them with pip install sherlock-project holehe maigret and verify with 'which sherlock' in your terminal. If using a virtualenv, activate it in the command entry or use the full path to the executable.

SpiderFoot, GHunt, or Blackbird are not found

The server expects these repos at /opt/spiderfoot, /opt/ghunt, and /opt/blackbird respectively. Clone them to those exact paths and install each tool's requirements.txt. If you clone elsewhere, you may need to edit the server source to point to the correct paths.

SpiderFoot scans time out or never complete

SpiderFoot deep reconnaissance scans can take 5–30 minutes depending on the target and enabled modules. Do not cancel the tool call prematurely. For faster results, use Sherlock or Blackbird for username lookups and TheHarvester for domain intelligence.

Frequently Asked Questions about OSINT Tools

What is OSINT Tools?

OSINT Tools is a Model Context Protocol (MCP) server that mcp server exposing multiple osint tools for ai assistants like claude It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OSINT Tools?

Follow the installation instructions on the OSINT Tools GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with OSINT Tools?

OSINT Tools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is OSINT Tools free to use?

Yes, OSINT Tools is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

OSINT Tools Alternatives — Similar Security Servers

Looking for alternatives to OSINT Tools? Here are other popular security servers you can use with Claude, Cursor, and VS Code.

Casdoor

13.6k

An open-source Agent-first Identity and Access Management (IAM) /LLM MCP & agent gateway and auth server with web UI supporting OpenClaw, MCP, OAuth, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, Face ID, Google Workspace, Azure AD

ghidraMCP

9.0k

An Model Context Protocol server that enables LLMs to autonomously reverse engineer applications by exposing Ghidra's decompilation and analysis tools. It allows AI agents to list code structures, rename methods, and analyze binaries directly through

HexStrike AI

8.9k

HexStrike AI MCP Agents is an advanced MCP server that lets AI agents (Claude, GPT, Copilot, etc.) autonomously run 150+ cybersecurity tools for automated pentesting, vulnerability discovery, bug bounty automation, and security research. Seamlessly b

IDA Pro MCP

8.7k

Enables AI-assisted reverse engineering in IDA Pro by providing tools to analyze binaries, decompile functions, manage comments, search patterns, and interact with the IDA database through natural language.

Anthropic Cybersecurity Skills

6.6k

754 structured cybersecurity skills for AI agents · Mapped to 5 frameworks: MITRE ATT&CK, NIST CSF 2.0, MITRE ATLAS, D3FEND & NIST AI RMF · agentskills.io standard · Works with Claude Code, GitHub Copilot, Codex CLI, Cursor, Gemini CLI & 20+ platform

Hooker

5.1k

🔥🔥 hooker is a Frida-based reverse engineering toolkit for Android. It offers a user-friendly CLI, universal scripts, auto hook generation, memory roaming to detect activities/services, one-click SOCKS5 proxy setup, Frida JustTrustMe, and BoringSSL u

Browse More Security MCP Servers

Explore all security servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "osint-tools": { "command": "npx", "args": ["-y", "osint-tools"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use OSINT Tools?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides