Osint Mcp
by rjn32scommunityv0.1.1
osint-mcp is a Python MCP server that exposes 26 free OSINT tools for tasks like WHOIS, DNS, subdomain enumeration, username searches, email breach checks, port scanning, and secrets scanning. It can auto-install the underlying binaries on macOS or Linux and makes them available to MCP clients through one server.
From the registry: 26 free OSINT tools as MCP tools for AI agents. Auto-installs everything on first run.
Install & configure
Prerequisites
- optionalInstall uv / uvxInstall uv so you can run the recommended one-command launcher `uvx osint-mcp`. The README recommends `uvx` as the simplest install path.https://docs.astral.sh/uv/
- optionalmacOS: Install HomebrewOn macOS, Homebrew must be installed in advance so osint-mcp can auto-install underlying OSINT tool binaries on first run.https://brew.sh/
- optionalInstall Go 1.21+Go is required for some underlying tools (such as subfinder, amass, phoneinfoga, gitleaks). The installer may skip those tools gracefully if Go is absent, but full tool coverage needs Go 1.21+.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `osint-mcp` MCP server into my current AI client (that's you).
Optional prerequisites:
- Install uv / uvx — Install uv so you can run the recommended one-command launcher `uvx osint-mcp`. The README recommends `uvx` as the simplest install path. (https://docs.astral.sh/uv/)
- macOS: Install Homebrew — On macOS, Homebrew must be installed in advance so osint-mcp can auto-install underlying OSINT tool binaries on first run. (https://brew.sh/)
- Install Go 1.21+ — Go is required for some underlying tools (such as subfinder, amass, phoneinfoga, gitleaks). The installer may skip those tools gracefully if Go is absent, but full tool coverage needs Go 1.21+.
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["osint-mcp"]
Note: Runs over stdio. On first run, `uvx osint-mcp` auto-installs the package and underlying OSINT tool binaries, then starts the MCP server. Optional API keys are configured via the server's own CLI/tools (`osint-mcp config set ...`) rather than documented as MCP config env vars. Python 3.10+ is required, but the README states it is bundled/handled when using uvx.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Runs over stdio. On first run, `uvx osint-mcp` auto-installs the package and underlying OSINT tool binaries, then starts the MCP server. Optional API keys are configured via the server's own CLI/tools (`osint-mcp config set ...`) rather than documented as MCP config env vars. Python 3.10+ is required, but the README states it is bundled/handled when using uvx.
Tools (26)
osint_whois
WHOIS lookup — registrar, creation date, expiry, nameservers
osint_dns_lookup
DNS records lookup for A, AAAA, MX, NS, TXT, CNAME, SOA, PTR, SRV, and CAA
osint_port_scan
Port and service scan with version detection
osint_ip_info
IP geolocation, ISP, org, timezone, and abuse contact
osint_asn_lookup
ASN number, BGP prefix, and network owner lookup
osint_subdomain_enum
Passive subdomain enumeration from 40+ sources
osint_amass
Deep attack-surface mapping across DNS, certs, and APIs
osint_cert_transparency
Certificate transparency log search to reveal subdomains via SSL certs
osint_harvester
Find email addresses, hostnames, and employee names from public sources
osint_dnsrecon
Zone transfer attempts, SRV enumeration, and reverse lookups
osint_username_search
Username search across 300+ social platforms
osint_maigret
Deep username profiling across 3,000+ sites with profile extraction
osint_email_accounts
Environment variables
shodan_keyrequiredAPI key for Shodan tools to enable full functionalityvirustotal_keyrequiredAPI key for VirusTotal lookups to enable full functionalityipinfo_keyrequiredAPI key for ipinfo.io tools to enable full functionalityhibp_keyrequiredAPI key for HaveIBeenPwned email breach checks to enable full functionalityurlscan_keyrequiredAPI key for urlscan.io scans to enable full functionalityPrerequisites
- • Python 3.10+
Packages
osint-mcp
pypiv0.1.1transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- Jun 27, 2026
- Last commit
- Jun 27, 2026
- Registry name
- io.github.rjn32s/osint-mcp