OSINT Agent
AI-powered OSINT agent with interactive REPL, MCP server, and CLI. 9 tools. Works with Claude, GPT-4, or local models. For authorized security research only.
What is OSINT Agent?
OSINT Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ai-powered osint agent with interactive repl, mcp server, and cli. 9 tools. works with claude, gpt-4, or local models. for authorized security research only.
AI-powered OSINT agent with interactive REPL, MCP server, and CLI. 9 tools. Works with Claude, GPT-4, or local models. For authorized security research only.
This server falls under the Security category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- AI-powered OSINT agent with interactive REPL, MCP server, an
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx openosintConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use OSINT Agent
OpenOSINT is an AI-powered open-source intelligence (OSINT) agent that exposes 16 specialized investigation tools as an MCP server, letting Claude and other AI models directly invoke capabilities like email breach detection, username enumeration across 300+ platforms, domain/subdomain discovery, Shodan port scanning, VirusTotal malware checks, and more. It connects to services including HaveIBeenPwned, Shodan, VirusTotal, Censys, AbuseIPDB, and GitHub via their respective APIs, and chains those results automatically during AI-driven investigations. Security researchers and analysts use it to conduct comprehensive OSINT workflows inside their AI assistant without switching between tools. All use must be authorized and legal.
Prerequisites
- Python 3.8+ installed on your system
- pip install openosint (available on PyPI)
- An ANTHROPIC_API_KEY (or compatible OpenAI/Ollama endpoint) for the AI backend
- Optional but recommended: API keys for HIBP, Shodan, VirusTotal, Censys, AbuseIPDB, and others stored in a .env file
- An MCP-compatible client such as Claude Desktop or Claude Code
Install OpenOSINT from PyPI
Install the main package using pip. This installs the core agent and the MCP server script.
pip install openosintInstall optional OSINT CLI tools
Several tools enhance functionality. holehe checks email account presence, sherlock searches usernames across 300+ sites, and sublist3r enumerates subdomains. These are optional but highly recommended.
pip install holehe sherlock-project sublist3rConfigure API keys in a .env file
Create a .env file at the project root. At minimum set ANTHROPIC_API_KEY. Add optional keys for services you want to use — each unlocks additional tools.
ANTHROPIC_API_KEY=your_anthropic_key
HIBP_API_KEY=your_hibp_key
SHODAN_API_KEY=your_shodan_key
VIRUSTOTAL_API_KEY=your_virustotal_key
CENSYS_API_ID=your_censys_id
CENSYS_SECRET=your_censys_secret
ABUSEIPDB_API_KEY=your_abuseipdb_key
GITHUB_TOKEN=your_github_token
IPINFO_TOKEN=your_ipinfo_tokenTest the agent interactively
Run openosint in interactive REPL mode to confirm tools work before connecting to an MCP client.
openosintConfigure Claude Desktop to use the MCP server
Edit your Claude Desktop config file to add the OpenOSINT MCP server. Replace the path with the actual location of your cloned/installed mcp_server.py.
Add the MCP server entry to claude_desktop_config.json
Add the server block pointing to the mcp_server.py file. Claude Desktop must be restarted after saving.
{
"mcpServers": {
"openosint": {
"command": "python",
"args": ["/path/to/openosint/mcp_server.py"]
}
}
}Alternatively, add via Claude Code CLI
If using Claude Code, register the server with one command.
claude mcp add openosint python /path/to/openosint/mcp_server.pyOSINT Agent Examples
Client configuration
Claude Desktop config entry for the OpenOSINT MCP server.
{
"mcpServers": {
"openosint": {
"command": "python",
"args": ["/path/to/openosint/mcp_server.py"]
}
}
}Prompts to try
Example prompts that exercise the 16 OSINT tools exposed by this server.
- "Check if [email protected] has appeared in any data breaches"
- "Find all online accounts linked to the username johndoe99"
- "Run a WHOIS lookup on example.com and enumerate its subdomains"
- "Look up IP 8.8.8.8 — get geolocation, ASN, open ports from Shodan, and abuse score from AbuseIPDB"
- "Search GitHub for public repositories and emails associated with the user handle hacker123"
- "Scan the domain malicious-site.com for VirusTotal verdicts and DNS records"Troubleshooting OSINT Agent
Tool returns 'holehe/sherlock not found' error
Install the missing CLI tools: pip install holehe sherlock-project. For phoneinfoga, download the binary from the GitHub releases page and ensure it is on your PATH.
ANTHROPIC_API_KEY not found or authentication error
Ensure your .env file is in the project root and contains a valid ANTHROPIC_API_KEY. The python-dotenv library loads it automatically at startup. Alternatively, set the variable in your shell environment.
MCP server not appearing in Claude Desktop
Verify the full absolute path to mcp_server.py is correct, that Python is on your PATH (run 'which python' to confirm), and restart Claude Desktop completely after editing claude_desktop_config.json.
Frequently Asked Questions about OSINT Agent
What is OSINT Agent?
OSINT Agent is a Model Context Protocol (MCP) server that ai-powered osint agent with interactive repl, mcp server, and cli. 9 tools. works with claude, gpt-4, or local models. for authorized security research only. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install OSINT Agent?
Follow the installation instructions on the OSINT Agent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with OSINT Agent?
OSINT Agent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is OSINT Agent free to use?
Yes, OSINT Agent is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
OSINT Agent Alternatives — Similar Security Servers
Looking for alternatives to OSINT Agent? Here are other popular security servers you can use with Claude, Cursor, and VS Code.
Casdoor
★ 13.6kAn 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.0kAn 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.9kHexStrike 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.7kEnables 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.6k754 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.
Set Up OSINT Agent in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use OSINT Agent?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.