
osint-mcp-server
by badchars·★ 17·Score 45
An OSINT intelligence MCP server with 37 tools across 12 sources for comprehensive reconnaissance and attack surface mapping.
Overview
The osint-mcp-server provides AI agents with comprehensive open-source intelligence capabilities through Model Context Protocol. It aggregates 37 tools from 12 different sources including Shodan, VirusTotal, Censys, SecurityTrails, and more. The server enables parallel querying across all sources, automatic data correlation, and intelligent analysis of attack surfaces. Unlike traditional OSINT workflows that require manually switching between multiple platforms, this MCP server allows AI agents to execute reconnaissance operations through natural language requests, receiving consolidated intelligence with actionable insights. The implementation is production-ready with 21 free tools and 16 premium tools requiring optional API keys.
Try asking AI
After installing, here are 7 things you can ask your AI assistant:
When to choose this
Choose this server when you need comprehensive OSINT capabilities for AI agents, especially when performing reconnaissance across multiple data sources simultaneously and correlating results automatically.
When NOT to choose this
Avoid this server if you need highly specialized OSINT tools not included in the 37 available tools, or if you require offline capabilities without API access to the included data sources.
Tools this server exposes
12 tools extracted from the READMEdns_lookupResolve A, AAAA, MX, TXT, NS, SOA, CNAME, SRV records
dns_reverseReverse DNS (PTR) lookup for an IP address
dns_email_securitySPF + DMARC + DKIM analysis with risk scoring
whois_domainRDAP domain lookup - registrar, dates, contacts
whois_ipRDAP IP lookup - network name, CIDR, entities
crtsh_searchSearch CT logs via crt.sh - subdomain discovery
shodan_hostIP details: open ports, services, vulnerabilities
shodan_searchSearch Shodan query language for hosts
shodan_exploitsSearch public exploit database
vt_domainDomain reputation and detection stats
vt_ipIP reputation and detection stats
vt_subdomainsDiscover subdomains via VirusTotal
Comparable tools
Installation
Quick Install
Option 1: npx (no install)
npx osint-mcp-serverOption 2: Clone
git clone https://github.com/badchars/osint-mcp-server.git
cd osint-mcp-server
bun installEnvironment Variables (Optional)
# Premium OSINT sources — all optional
export SHODAN_API_KEY=your-key # Enables 4 Shodan tools
export VT_API_KEY=your-key # Enables 4 VirusTotal tools
export ST_API_KEY=your-key # Enables 3 SecurityTrails tools
export CENSYS_API_ID=your-id # Enables 3 Censys tools
export CENSYS_API_SECRET=your-secret # Required with CENSYS_API_IDClaude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"osint": {
"command": "npx",
"args": ["-y", "osint-mcp-server"],
"env": {
"SHODAN_API_KEY": "optional",
"VT_API_KEY": "optional",
"ST_API_KEY": "optional",
"CENSYS_API_ID": "optional",
"CENSYS_API_SECRET": "optional"
}
}
}
}FAQ
- How many tools are available without API keys?
- 21 tools work immediately without any API keys, covering DNS, WHOIS, crt.sh, GeoIP, BGP, Wayback Machine, HackerTarget, and Microsoft 365 tenant discovery.
- Which AI agents support this MCP server?
- The server works with any MCP-compatible AI client including Claude Desktop, Claude Code, Cursor, Windsurf, and others that support the Model Context Protocol.
- Does it require programming knowledge to use?
- No. The server is designed to work through natural language conversations with AI agents. Users simply ask questions in plain English and the agent handles the tool execution and correlation.
Compare osint-mcp-server with
Last updated · Auto-generated from public README + GitHub signals.