Skip to content

v0.1.0 — Initial Release

Choose a tag to compare

View all tags
@badchars badchars released this 17 Mar 01:15
· 16 commits to main since this release
v0.1.0
86670f3

osint-mcp-server v0.1.0

OSINT & reconnaissance intelligence for AI agents — 37 tools across 12 data sources via the Model Context Protocol.

Quick Start

npx osint-mcp-server

Highlights

  • 37 tools across 12 OSINT providers
  • 21 free tools — DNS, WHOIS, crt.sh, GeoIP, BGP, Wayback Machine, HackerTarget, M365 — no API keys required
  • 4 premium providers — Shodan (4 tools), VirusTotal (4), SecurityTrails (3), Censys (3) — optional API keys
  • 2 dependencies — @modelcontextprotocol/sdk + zod, everything else is native fetch + dns/promises
  • Per-provider rate limiters — calibrated to each API's limits
  • TTL caching — avoid redundant calls during multi-tool workflows
  • Graceful degradation — missing API keys return descriptive messages, never crash

Tools by Category

Category Tools Auth
DNS dns_lookup, dns_reverse, dns_email_security, dns_spf_chain, dns_srv_discover, dns_wildcard_check Free
WHOIS/RDAP whois_domain, whois_ip Free
crt.sh crtsh_search Free
GeoIP geoip_lookup, geoip_batch Free
BGP/ASN bgp_asn, bgp_ip, bgp_prefix Free
Wayback wayback_urls, wayback_snapshots Free
HackerTarget hackertarget_hostsearch, hackertarget_reverseip, hackertarget_aslookup Free
M365 m365_tenant, m365_userrealm Free
Meta osint_list_sources, osint_domain_recon Free
Shodan shodan_host, shodan_search, shodan_dns_resolve, shodan_exploits API Key
VirusTotal vt_domain, vt_ip, vt_subdomains, vt_url API Key
SecurityTrails st_subdomains, st_dns_history, st_whois API Key
Censys censys_hosts, censys_host_details, censys_certificates API Key

Connect to Your AI Agent

# Claude Code
claude mcp add osint-mcp-server -- npx osint-mcp-server

# Or add to Claude Desktop config

Documentation

README available in 23 languages: English, 简体中文, 繁體中文, 한국어, Deutsch, Español, Français, Italiano, Dansk, 日本語, Polski, Русский, Bosanski, العربية, Norsk, Português (Brasil), ไทย, Türkçe, Українська, বাংলা, Ελληνικά, Tiếng Việt, हिन्दी

Part of the MCP Security Suite

Project Domain
hackbrowser-mcp Browser-based security testing
cloud-audit-mcp Cloud security (AWS/Azure/GCP)
github-security-mcp GitHub security posture
cve-mcp Vulnerability intelligence
osint-mcp-server OSINT & reconnaissance
Assets 2
Loading