OpenOSINT

Official

by OpenOSINT · Python

AI-powered OSINT agent & MCP server. 16 tools: email, breach, IP, WHOIS, DNS, Shodan, GitHub & more.

io.github.SonoTommy/openosint MCP Server

The AI-powered OSINT agent and MCP server exposes 16 tools for reconnaissance, including email, breach, IP, WHOIS, DNS, Shodan, GitHub, and more. It provides a model-context protocol server to coordinate tool usage and responses, enabling structured, repeatable investigations.

🛠️ Key Features

16 integrated OSINT tools (email, breach, IP, WHOIS, DNS, Shodan, GitHub, and more)
Model Context Protocol (MCP) server for structured tool orchestration
Natural-language interface with executable real binaries
Grounded outputs with hard-stop tool calls to avoid hallucinations

🚀 Use Cases

Threat research and threat-hunting workflows
Security posture assessments and reconnaissance
OSINT investigations for analysts and researchers
Repl/CLI or browser-based interaction with MCP server

⚡ Developer Benefits

Clear MCP server exposure for tool orchestration
Extensible tool suite across security domains
Grounded, verifiable results through deterministic tool calls
Convenient packaging for automation and pipelines

⚠️ Limitations

Relies on available tools; tool coverage may vary
Requires proper credentials for certain data sources
Results depend on tool outputs and may require corroboration

Topics

ai-agentanthropicclaudecybersecurityosintpythonsecurityterminalcliholehemcpsherlockllmmcp-servermodel-context-protocolthreat-intelligencemaigretosint-toolsreconnaissance

README.md33 KBView on GitHub

mcp-name: io.github.OpenOSINT/openosint

OpenOSINT

OSINT agent for security researchers and analysts: 19 investigation tools behind a natural-language interface.

Use it as a REPL, CLI, MCP server, or browser Web UI.

The AI issues hard-stop tool calls; your code executes the real binary — hallucinated findings are structurally impossible.

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.

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

OpenOSINT running a DNS lookup and returning records in under two seconds

bash

pip install openosint

Paid: Complete Kit — $55 (prompts + playbook, bundled) · Setup Sprint — $350 (done-for-you install) · Commercial License — from €300/yr (vendor contract, SLA, indemnification)

Quick Start

bash

# Interactive AI REPL (default)
openosint

# Web interface
openosint web

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

New to OSINT methodology? Grab the free 5-prompt starter set or the free Playbook edition before your first run.

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

Run in the cloud (no install)

No Python, no holehe / sherlock / sublist3r / phoneinfoga binaries in PATH, no API keys — run OpenOSINT Email Recon from your browser, or as an MCP tool in Claude, Cursor, and Windsurf via the Apify MCP Server. Try for free.

Try OpenOSINT Email Recon on Apify →

Usage

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

text

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

Features

Capability	Details
AI tool chaining	The agent selects and chains tools based on findings; describe the target in plain language
19 modular tools	Email, username, breach, WHOIS, IP, subdomain, dorks, paste, phone, Shodan, VirusTotal, Censys, IP2Location, AbuseIPDB, GitHub, DNS, live dork search, URL scraping, SERP footprint
Three AI backends	Anthropic Claude (default), local Ollama, or any OpenAI-compatible endpoint (LiteLLM, vLLM, LM Studio, ...)
Native MCP server	All 19 tools exposed to Claude Code, Claude Desktop, and any MCP-compatible client — no extra config
Parallel execution	`--parallel` runs complementary tools concurrently via `asyncio.gather()`
Reports	PDF + Markdown auto-saved after every investigation (`reportlab` optional)
Session history	All REPL sessions saved to `~/.openosint/history/`; browse with `openosint history`
Web UI	Browser-based AI chat with streaming output, tool cards, light/dark theme

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.

Custom Integrations

Need OpenOSINT wired into your SOC, fraud, threat-intel, or AI-agent stack? I build bespoke OSINT integrations for teams — you bring the data sources and compliance requirements, I deliver a working integration.

→ Get in touch

Tools

Tool	Powered by	What it investigates
`search_email`	holehe	Social accounts linked to an email address
`search_username`	sherlock	Username presence across 300+ platforms
`search_breach`	HaveIBeenPwned v3 API	Data breach exposure
`search_whois`	python-whois	Domain registrant and DNS info
`search_ip`	ipinfo.io	Geolocation, ASN, hostname
`search_domain`	sublist3r	Subdomain enumeration
`generate_dorks`	built-in	12 targeted Google dork URLs (no network calls)
`search_paste`	psbdmp.ws	Pastebin dump mentions
`search_phone`	phoneinfoga	Carrier, country, line type
`search_shodan`	Shodan API	Open ports, banners, CVEs
`search_virustotal`	VirusTotal API v3	Verdict from 70+ antivirus engines
`search_ip2location`	IP2Location.io API	Enhanced IP intel: VPN/Proxy/Tor/datacenter flags (sponsored)
`search_censys`	Censys Search API	Internet-facing infrastructure, certificates
`search_abuseipdb`	AbuseIPDB v2 API	IP abuse reputation: confidence score, reports, country, ISP
`search_github`	GitHub REST API	Profile, repos, commit-discovered emails, username/keyword search
`search_dns`	dnspython (built-in)	A/AAAA/MX/NS/TXT/CNAME/SOA records; SPF, DMARC, DKIM analysis
`search_dorks_live`	Bright Data SERP API	Live Google search results for dork queries (title, URL, snippet)
`scrape_url`	Bright Data Web Unlocker	Fetch any URL bypassing Cloudflare/CAPTCHA — returns clean Markdown
`search_footprint`	Bright Data SERP API	Entity-type-aware public search-engine footprint: detects email/username/domain/phone/name and returns structured results + Entity Correlation Graph nodes/edges

Full per-tool documentation, CLI flags, and output formats: openosint.tech.

search_email

Enumerates online services linked to an email address using holehe.

bash

openosint email target@example.com

text

[+] Spotify        https://open.spotify.com/user/target
[+] WordPress      https://wordpress.com/target
[+] Gravatar       https://gravatar.com/target
[+] Office365      email used

search_username

Searches for a username across 300+ platforms using sherlock.

bash

openosint username johndoe99

text

[+] GitHub         https://github.com/johndoe99
[+] Twitter        https://twitter.com/johndoe99
[+] Reddit         https://reddit.com/user/johndoe99

search_breach

Checks data breach exposure via HaveIBeenPwned v3 API. Requires HIBP_API_KEY.

text

[+] LinkedIn (2016-05-05) — leaked: Email addresses, Passwords
[+] Adobe (2013-10-04) — leaked: Email addresses, Password hints

search_whois

Retrieves WHOIS data using python-whois.

text

[+] Registrar: ICANN
[+] Created: 1995-08-14
[+] Expires: 2024-08-13
[+] Name Servers: A.IANA-SERVERS.NET

search_ip

Retrieves geolocation and ASN data via ipinfo.io. Free tier: 50k/month.

text

[+] Hostname: dns.google
[+] Org: AS15169 Google LLC
[+] City: Mountain View, CA, US

search_domain

Enumerates subdomains using sublist3r.

text

[+] mail.example.com
[+] dev.example.com
[+] api.example.com

generate_dorks

Generates 12 targeted Google dork URLs for any target. No network calls.

text

[+] "johndoe" site:linkedin.com
    https://www.google.com/search?q=%22johndoe%22+site%3Alinkedin.com
[+] "johndoe" leaked OR breach OR dump
    https://www.google.com/search?q=%22johndoe%22+leaked+OR+breach+OR+dump

search_paste

Searches Pastebin dumps via psbdmp.ws.

text

[+] https://pastebin.com/aB1cD2eF (2023-04-12)
[+] https://pastebin.com/xY3zA4bC (2022-11-08)

search_phone

Gathers phone intelligence using phoneinfoga. Use E.164 format.

text

[+] Country: United States
[+] Carrier: AT&T
[+] Line type: Mobile

search_shodan

IPv4 input → host lookup (open ports, org, CVEs). Any other query → banner/keyword search. Requires SHODAN_API_KEY.

bash

openosint shodan 8.8.8.8
openosint shodan "apache port:80 country:DE"

text

[+] Org: Google LLC  |  Open ports: 53, 443

search_virustotal

Checks an IP, domain, URL, or file hash against VirusTotal's 70+ engines. Auto-detects input type. Requires VIRUSTOTAL_API_KEY.

bash

openosint virustotal 8.8.8.8
openosint virustotal example.com
openosint virustotal 44d88612fea8a8f36de82e1278abb02f

text

[VirusTotal] Malicious: 0 / Harmless: 72

search_ip2location

Queries IP2Location.io for enhanced IP intelligence: geolocation, ISP, ASN, and — on the Security Plan — VPN/Proxy/Tor/datacenter detection. Sponsored integration. Requires IP2LOCATION_API_KEY.

bash

openosint ip2location 8.8.8.8

text

[IP2Location] City: Mountain View, CA, US  |  ISP: Google LLC
[IP2Location] VPN: No  |  Proxy: No  |  TOR: No  |  Datacenter: Yes

search_censys

IPv4 → host view (open ports, services, ASN). Domain → certificate search (SANs, issuer). Requires CENSYS_API_ID and CENSYS_SECRET.

bash

openosint censys 8.8.8.8
openosint censys example.com

text

[Censys] Open Ports: 53, 443, 853  |  ASN: AS15169 Google LLC

search_abuseipdb

Checks an IP against AbuseIPDB v2. Returns abuse confidence score, total reports, country, ISP, and last reported timestamp. Requires ABUSEIPDB_API_KEY.

bash

openosint abuseipdb 198.51.100.1

text

[AbuseIPDB] Abuse Confidence Score: 87%  |  Total Reports: 143
⚠️  HIGH ABUSE CONFIDENCE — flagged by AbuseIPDB

Warning appears when abuseConfidenceScore exceeds 50%.

search_github

Queries GitHub REST API. Username → profile, repos, commit-discovered emails. Keyword → user/repo search. Optional GITHUB_TOKEN raises rate limit from 60 to 5000 req/h.

bash

openosint github johndoe99

text

[GitHub] Repos: 42  |  Followers: 128
[GitHub] Commit email: johndoe@example.com

search_dns

Queries A/AAAA/MX/NS/TXT/CNAME/SOA records and analyzes SPF, DMARC, and DKIM configuration using dnspython (no external API).

bash

openosint dns example.com

text

[DNS] A: 93.184.216.34
[DNS] MX: mail.example.com (priority 10)
[DNS] SPF: v=spf1 include:_spf.google.com ~all

search_dorks_live

Executes live Google dork queries through the Bright Data SERP API¹, returning structured results (title, URL, snippet). Defaults to 5 dorks per run; each is a separate billable API call. Requires BRIGHTDATA_API_KEY and BRIGHTDATA_SERP_ZONE.

bash

openosint search-dorks-live "john doe" --max-dorks 3

text

[+] Dork: "john doe" site:linkedin.com
    Title:   John Doe | LinkedIn
    URL:     https://www.linkedin.com/in/john-doe-12345

scrape_url

Fetches any public URL through Bright Data Web Unlocker¹, bypassing Cloudflare/CAPTCHA. Returns clean Markdown. Requires BRIGHTDATA_API_KEY and BRIGHTDATA_UNLOCKER_ZONE.

bash

openosint scrape https://example.com

text

[Web Unlocker] Remote status: 200
# Example Domain
This domain is for use in illustrative examples in documents.

search_footprint

Collects a target's public search-engine footprint via Bright Data SERP API¹. Detects entity type (email, username, domain, phone, or full name) and runs entity-type-aware Google queries, returning structured results plus Entity Correlation Graph nodes/edges for discovered domains and profiles. Requires BRIGHTDATA_API_KEY and BRIGHTDATA_SERP_ZONE.

bash

openosint footprint johndoe99

Interfaces

Web UI

bash

pip install "openosint[web]"
openosint web
# Opens http://localhost:8080 automatically

Browser-based AI chat with streaming tool output, inline result cards, light/dark theme toggle. Supports local inference via Ollama or any OpenAI-compatible endpoint — no Anthropic API key required.

OpenOSINT Web UI — live entity correlation graph demo: investigating openosint.tech

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

bash

# Fully local (no API key) — requires Ollama runtime: https://ollama.com
ollama pull llama3.2
openosint web
# Settings -> Ollama (local) -> model: llama3.2

# OpenAI-compatible endpoint (LiteLLM, vLLM, LM Studio, ...)
export OPENAI_BASE_URL="http://localhost:4000/v1"
openosint web
# Settings -> OpenAI API

Interactive REPL

Run openosint with no arguments to start the AI-powered REPL:

REPL commands:

Command	Description
`<target>`	Investigate any target — email, username, domain, IP, name
`clear`	Reset conversation memory
`save`	Save last report to `reports/`
`tools`	List available tools and their status
`config`	Show current configuration
`history`	Browse saved sessions
`help`	Show all commands
`exit` / Ctrl-D	Exit

All sessions are auto-saved to ~/.openosint/history/. Browse with openosint history.

For the REPL/CLI with an OpenAI-compatible backend:

bash

pip install "openosint[openai]"
openosint --provider openai \
  --openai-base-url http://localhost:4000/v1 \
  --openai-model gpt-4o-mini

Live Documentation

Full per-tool reference, CLI flags, and configuration options at openosint.tech.

openosint.tech documentation tour

MCP Server

Expose all 19 OpenOSINT tools to any MCP-compatible AI client. Once connected, Claude can natively invoke all 19 tools during conversations.

Claude Code:

bash

claude mcp add openosint python /absolute/path/to/OpenOSINT/openosint/mcp_server.py
claude mcp list

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "openosint": {
      "command": "python",
      "args": ["/absolute/path/to/OpenOSINT/openosint/mcp_server.py"]
    }
  }
}

Prefer zero setup? The OpenOSINT Email Recon Actor is also available as a hosted MCP tool via the Apify MCP Server — no server to run, no config file to edit. Try for free.

Agentic use via Claude Code:

text

$ claude
> Investigate target@example.com. Trace any username found
  across other platforms and compile a full report.

Installation

bash

# From PyPI (recommended)
pip install openosint

# From source
git clone https://github.com/OpenOSINT/OpenOSINT.git
cd OpenOSINT
pip install -e .

External binaries (must be in PATH):

Binary	Purpose	Install
`holehe`	Email account enumeration	`pip install holehe`
`sherlock`	Username enumeration (300+ platforms)	`pip install sherlock-project`
`sublist3r`	Subdomain enumeration	`pip install sublist3r`
`phoneinfoga`	Phone number intelligence	Download binary

If a binary is absent, the corresponding tool returns a descriptive error. All other tools remain operational.

Don't want to install these locally? The OpenOSINT Email Recon Actor runs email recon in Apify's cloud — zero dependencies, zero local setup.

Optional Python packages:

Package	Purpose	Install
`ollama`	Local LLM backend (no API key)	`pip install ollama` (also requires Ollama runtime)
`openai`	OpenAI-compatible backend	`pip install "openosint[openai]"`
`shodan`	Shodan API client	`pip install shodan`
`reportlab`	PDF report export	`pip install reportlab`
`censys`	Censys API client	`pip install censys`

Configuration

Store keys in a .env file at the project root (copy .env.example). python-dotenv loads it automatically at startup.

Variable	Tool	Required	Purpose
`ANTHROPIC_API_KEY`	AI agent	Yes (or Ollama / OpenAI)	Anthropic API key
`OPENAI_BASE_URL`	AI agent	Optional	Base URL of an OpenAI-compatible endpoint (e.g. `http://localhost:4000/v1`)
`OPENAI_API_KEY`	AI agent	Optional	API key for the endpoint (local servers may ignore it)
`OPENAI_MODEL`	AI agent	Optional	Model name to request (default: `gpt-4o-mini`)
`HIBP_API_KEY`	`search_breach`	Optional	HaveIBeenPwned v3 — get one
`IPINFO_TOKEN`	`search_ip`	Optional	ipinfo.io higher rate limits
`SHODAN_API_KEY`	`search_shodan`	Optional	Shodan API — get one
`VIRUSTOTAL_API_KEY`	`search_virustotal`	Optional	VirusTotal API v3 — get one
`IP2LOCATION_API_KEY`	`search_ip2location`	Optional	IP2Location.io — get one (sponsored)
`CENSYS_API_ID` + `CENSYS_SECRET`	`search_censys`	Optional	Censys — get one
`ABUSEIPDB_API_KEY`	`search_abuseipdb`	Optional	AbuseIPDB v2 — get one
`GITHUB_TOKEN`	`search_github`	Optional	GitHub API — raises rate limit 60 → 5000 req/h — get one
`BRIGHTDATA_API_KEY`	`search_dorks_live`, `scrape_url`, `search_footprint`	Optional	Bright Data — get one¹ (free tier: 5,000 req/month)
`BRIGHTDATA_SERP_ZONE`	`search_dorks_live`, `search_footprint`	Optional	Your Bright Data SERP zone name (e.g. `serp_api1`)
`BRIGHTDATA_UNLOCKER_ZONE`	`scrape_url`	Optional	Your Bright Data Web Unlocker zone name (e.g. `web_unlocker1`)

CLI Reference

Flag / Subcommand	Description
`openosint`	Interactive AI REPL (default)
`openosint web [--port N] [--no-browser]`	Launch browser UI
`openosint email ADDRESS [-t N]`	Direct email scan
`openosint username HANDLE [-t N]`	Direct username scan
`openosint shodan QUERY [-t N]`	Shodan lookup
`openosint virustotal TARGET [-t N]`	VirusTotal lookup
`openosint censys TARGET [-t N]`	Censys lookup
`openosint ip2location IP [-t N]`	IP2Location lookup
`openosint abuseipdb IP [-t N]`	AbuseIPDB reputation check
`openosint github QUERY [-t N]`	GitHub profile/repo/email discovery
`openosint dns DOMAIN [-t N]`	DNS records + email security analysis
`openosint multi TARGETS`	Parallel multi-target investigation (max 10)
`openosint history [--all] [open N] [clear]`	View/manage REPL session history
`-v, --verbose`	Enable debug logging to stderr
`-t, --timeout N`	Override subprocess timeout (seconds)
`--api-key KEY`	Anthropic API key (overrides env var)
`--parallel`	Run complementary tools concurrently
`--json`	Output results as structured JSON
`--provider {anthropic,ollama,openai}`	AI provider (default: `anthropic`)
`--ollama-model MODEL`	Ollama model name (default: `llama3.2`)
`--ollama-host URL`	Ollama server URL (default: `http://localhost:11434`)
`--openai-base-url URL`	OpenAI-compatible endpoint base URL (env: `OPENAI_BASE_URL`)
`--openai-model MODEL`	Model to request from the endpoint (default: `gpt-4o-mini`; env: `OPENAI_MODEL`)
`--openai-api-key KEY`	API key for the endpoint (env: `OPENAI_API_KEY`)
`--no-pdf`	Disable automatic PDF generation

Docker

bash

# Build and run
docker compose up --build

# One-off command
docker compose run --rm openosint email target@example.com --json

Set ANTHROPIC_API_KEY (and optionally HIBP_API_KEY, IPINFO_TOKEN) in a .env file or export them before running docker compose. Reports are persisted to ./reports/ via a volume mount.

DigitalOcean App Platform: see .do/app.yaml for App Platform configuration.

Integrations

Service	URL	Tool	Tier	Auth
IP2Location.io	https://www.ip2location.io	`search_ip2location`	Featured (sponsored)	API key — free tier
RapidProxy	https://www.rapidproxy.io/?ref=openosint	—	Featured (sponsored)	—
AbuseIPDB	https://www.abuseipdb.com	`search_abuseipdb`	Community	API key — free tier
Censys	https://censys.io	`search_censys`	Community	API key — free tier
GitHub	https://github.com	`search_github`	Community	Token optional
HaveIBeenPwned	https://haveibeenpwned.com	`search_breach`	Community	API key — paid
holehe	https://github.com/megadose/holehe	`search_email`	Community	None — local binary
ipinfo.io	https://ipinfo.io	`search_ip`	Community	Token optional
phoneinfoga	https://github.com/sundowndev/phoneinfoga	`search_phone`	Community	None — local binary
psbdmp.ws	https://psbdmp.ws	`search_paste`	Community	None
sherlock	https://github.com/sherlock-project/sherlock	`search_username`	Community	None — local binary
Shodan	https://shodan.io	`search_shodan`	Community	API key — free tier
sublist3r	https://github.com/aboul3la/Sublist3r	`search_domain`	Community	None — local binary
VirusTotal	https://www.virustotal.com	`search_virustotal`	Community	API key — free tier
WHOIS (IANA)	https://www.iana.org/whois	`search_whois`	Community	None
DNS (system resolver)	—	`search_dns`	Community	None
Google Search	https://www.google.com	`generate_dorks`	Community	None

Get the Method

OpenOSINT is the tool. The AI OSINT Complete Kit ($55) is the method: the Prompt Pack and the Operator's Playbook, bundled.

→ Get the Complete Kit ($55)

AI OSINT Prompt Pack

OpenOSINT gives you the tooling. The AI OSINT Prompt Pack gives you the method: 30+ tested prompts across 8 target types, with one repeatable collect → pivot → verify → document flow for running OpenOSINT investigations.

Email, username, domain, IP, phone, company due-diligence, image & reporting prompts
One repeatable investigation flow + an ethics & legal primer
Instant download · pairs directly with OpenOSINT

→ Get the Prompt Pack ($29)

AI OSINT Operator's Playbook

Step-by-step workflows for running investigations with ChatGPT, Claude, and OpenOSINT.

→ Get the Playbook ($39)

Buying directly funds OpenOSINT's development.

AI OSINT Prompts — Free Starter Set

New to AI-assisted OSINT? The free starter set gives you 5 structured prompts — one per stage of a real investigation — that make ChatGPT and Claude collect real public data instead of hallucinating it.

Scope → Collect → Pivot → Verify → Document
Works with any AI assistant (Claude, ChatGPT, Gemini)
Instant PDF, no card required

→ Get the free starter set

AI OSINT Operator's Playbook — Free Edition

The free edition walks the 5-phase method once, end to end, on a single worked case: scope → collect → pivot → verify → document. Includes one sample prompt and the confidence rubric used to grade findings.

Free edition: the method + one worked investigation
Full edition ($39): 12 complete workflows, per-tool playbooks, reporting templates, and the legal/ethics primer

→ Get the free edition · Full Playbook ($39) →

OpenOSINT is used by OSINT practitioners, security researchers, and developers actively evaluating intelligence APIs. Every time a user configures an integration, the docs route them to that provider's sign-up page — high-intent exposure at the moment of adoption.

Featured Integration ($2,000/year or $220/month): recommended/default provider for one tool category, exclusive. Logo + badge across README, docs, CLI banner, and Web UI. One vendor per category.

Current sponsors and open categories are listed in the sponsor block at the top of this README. Full media kit, pricing, and the referral funnel: SPONSORSHIP.md.

Open Collective · commercial@openosint.tech · SPONSORSHIP.md

SERVICES

The framework is free and MIT-licensed. This is an optional paid setup service offered by the maintainer.

OSINT-MCP Setup Sprint — done-for-you installation and configuration of an autonomous OSINT-MCP pipeline on your environment. Fully async, no calls required.

Includes:

Pre-configured OpenOSINT setup tailored to your stack (Claude Code, Claude Desktop, or any MCP client)
API keys wired in (Shodan, VirusTotal, IP2Location, HaveIBeenPwned, and others as needed)
One investigation workflow built around your use case
Written step-by-step setup guide + screen-recorded walkthrough

Delivery: 3–5 days, fully async.

For: SOC analysts · threat-intel teams · fraud/AML · pentesters · OSINT investigators

Need it set up for you?

Get OpenOSINT wired into your stack in 3–5 days — done-for-you, fully async, no calls.

Book the Setup Sprint → $350 (founding price, first 5 teams)

→ Or email commercial@openosint.tech · LinkedIn

For authorized use only. See DISCLAIMER.md.

Commercial License & Support

OpenOSINT is free and MIT-licensed for everyone — personal projects, commercial products, SaaS, and closed-source are all covered with no purchase required. Organizations that additionally need a vendor contract, written warranty, indemnification, SLA, or priority support for procurement and compliance can purchase a commercial plan. Three tiers available from €300/year — see COMMERCIAL.md for full details and pricing. Contact: commercial@openosint.tech.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md for the development workflow, integration registration checklist, and coding conventions. Please read DISCLAIMER.md before contributing.

Regenerating the demo GIF/MP4

bash

export OPENOSINT_DEMO_KEY=sk-ant-...   # your Anthropic key — never committed
openosint --web &                      # start the web server on :8080
make demo                              # record -> encode -> write docs/assets/demo-web-graph.*
git add docs/assets/demo-web-graph.*

See scripts/record-demo/README.md for full prerequisites and pipeline details.

Maintainer

Tommaso Bertocchi

X (personal): https://x.com/SonoTommy_
X (OpenOSINT): https://x.com/openosint_oss
LinkedIn: https://www.linkedin.com/company/openosintoss
Email: commercial@openosint.tech

Contributors

Contributor	Contribution
@consocio	venv/uv-tool binary resolution fix — co-installed tools are now found without a separate activation step (#6)

License

OpenOSINT is open source under the MIT License — free for any use, including personal, commercial, academic, and closed-source.

¹ Bright Data links in this README are affiliate/referral links — OpenOSINT earns a commission if you sign up through them, at no extra cost to you.

For authorized security research only. See DISCLAIMER.md.

OpenOSINT v2.25.0 — July 2026

Star History

Star History Chart

Install

Configuration

Environment variables

ANTHROPIC_API_KEYrequiredsecret

Anthropic API key — required for the AI agent REPL

HIBP_API_KEYsecret

HaveIBeenPwned API key for breach detection (search_breach tool)

IPINFO_TOKENsecret

ipinfo.io token for higher IP lookup rate limits (search_ip tool)

IP2LOCATION_API_KEYsecret

IP2Location API key for enhanced IP intelligence (search_ip2location tool)

ABUSEIPDB_API_KEYsecret

AbuseIPDB API key for IP abuse reputation checks (search_abuseipdb tool)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "openosint": {
      "command": "uvx",
      "args": [
        "openosint"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "HIBP_API_KEY": "<YOUR_HIBP_API_KEY>",
        "IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>",
        "IP2LOCATION_API_KEY": "<YOUR_IP2LOCATION_API_KEY>",
        "ABUSEIPDB_API_KEY": "<YOUR_ABUSEIPDB_API_KEY>"
      }
    }
  }
}

io.github.SonoTommy/openosint MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

OpenOSINT

Featured Integrations

Quick Start

📬 Agents & OSINT — the newsletter

Run in the cloud (no install)

Usage

Features

Custom Integrations

Tools

search_email

search_username

search_breach

search_whois

search_ip

search_domain

generate_dorks

search_paste

search_phone

search_shodan

search_virustotal

search_ip2location

search_censys

search_abuseipdb

search_github

search_dns

search_dorks_live

scrape_url

search_footprint

Interfaces

Web UI

Interactive REPL

Live Documentation

MCP Server

Installation

Configuration

CLI Reference

Docker

Integrations

Get the Method

AI OSINT Prompt Pack

AI OSINT Operator's Playbook

AI OSINT Prompts — Free Starter Set

AI OSINT Operator's Playbook — Free Edition

Sponsor this project

SERVICES

Need it set up for you?

Commercial License & Support

Contributing

Regenerating the demo GIF/MP4

Maintainer

Contributors

License

Star History

Install

Configuration

Related servers