OpenOSINT

io.github.sonotommy/openosint · 605 stars · Python · MIT

MCP server AI-powered OSINT agent with interactive REPL, MCP server, and CLI. 20 tools. Works with Claude, GPT-4, or local models. For authorized security research only.

Install

In your shell

pip install openosint

These repos do not share one command. When an entry shows a command, it was copied as published. Check the repo's README before you run it.

Published as

PyPIopenosintstdio

From the server's entry in the official MCP Registry.

Configuration

Name	Set as	What it is
`ANTHROPIC_API_KEY`Required · Secret	Env var	Anthropic API key — required for the AI agent REPL
`HIBP_API_KEY`Optional · Secret	Env var	HaveIBeenPwned API key for breach detection (search_breach tool)
`IPINFO_TOKEN`Optional · Secret	Env var	ipinfo.io token for higher IP lookup rate limits (search_ip tool)
`IP2LOCATION_API_KEY`Optional · Secret	Env var	IP2Location API key for enhanced IP intelligence (search_ip2location tool)
`ABUSEIPDB_API_KEY`Optional · Secret	Env var	AbuseIPDB API key for IP abuse reputation checks (search_abuseipdb tool)

Files

README.md

mcp-name: io.github.OpenOSINT/openosint

Self-host (free, MIT)

pip install openosint

# Interactive AI REPL (default)
openosint

# Web interface
openosint web

# Direct tool (no AI)
openosint email target@example.com

Try the live demo → — bring your own Anthropic / OpenRouter / Ollama key, no signup.

☁️ OpenOSINT Cloud — no install, pay per use

Run OpenOSINT tools with zero install as pay-per-use Apify Actors, in your browser or as MCP tools in Claude, Cursor, and Windsurf.

All three are also available as MCP tools with no server to run: https://mcp.apify.com?tools=complete_analogy/openosint-email-recon,complete_analogy/openosint-username-recon,complete_analogy/openosint-domain-recon

Cloud or self-host? Cloud: zero setup, pay per call, hosted by us — cloud usage funds ongoing development of the self-hosted project. Self-host: free forever, your own API keys, full control.

📬 Agents & OSINT — the newsletter

One AI-OSINT workflow you can run + a ruthless roundup of what's new, every week. Subscribe →

Investigation results land live on the globe — click a point to pivot. Watch the sharper MP4.

The entities are seeded at the statement layer, not produced by today's mappers — see demo/README.md.

Featured Integrations

IP2Location.io — powers search_ip2location · Integration guide

Enhanced IP geolocation, ISP, VPN/Proxy/Tor, and datacenter detection

RapidProxy · Integration guide

Reliable Residential Proxies for Data Collection & Automation — 90M+ IPs across 200+ countries. 10% off: RAPID10.

TestMu AI

TestMu AI (formerly LambdaTest) is an AI-native testing cloud platform built for modern engineering teams. It covers everything from autonomous test creation and fast execution to testing AI agents, chatbots and voice assistants.

_Open: Breach / Compromised-Credential Data · Email / Identity Lookup — see SPONSORSHIP.md._

Usage

Start the REPL and investigate any target — the agent decides which tools to run and chains them on findings:

openosint > investigate target@example.com

  -> generate_dorks('target@example.com')
  -> search_email('target@example.com')
  Found: Spotify, WordPress, Gravatar, Office365

  -> search_breach('target@example.com')
  Found in 2 breaches: LinkedIn (2016), Adobe (2013)

  -> search_username('johndoe99')   <- pivoted from email findings
  Found: GitHub, Reddit, Twitter

  Report saved -> reports/2026-05-11_14-32-11_report.md

Want the full investigation workflow behind this? → AI OSINT Complete Kit ($55)

Features

Legal Disclaimer: OpenOSINT is intended for legal and authorized use only. Users are solely responsible for ensuring their use complies with all applicable laws and regulations. The authors accept no liability for misuse. See DISCLAIMER.md.

Tools

Facts

Kind: MCP server
Repo: io.github.sonotommy/openosint
Group: Uncategorized
Stars: 605
License: MIT
Language: Python
Last push: 2026-10-08
Forks: 273
MCP Registry: io.github.OpenOSINT/openosint
Homepage: openosint.tech
Topics: ai-agent, anthropic, claude, cli, cybersecurity, holehe, llm, maigret, mcp, mcp-server, model-context-protocol, osint, osint-tools, python, reconnaissance, security