MCP Recon
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Recon perform a passive subdomain enumeration on example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Recon
A comprehensive Model Context Protocol (MCP) server for web security reconnaissance and analysis. This toolkit provides cybersecurity professionals with essential reconnaissance capabilities through Python-native implementations, following the standard cybersecurity reconnaissance methodology.
š Features
š 1. Information Gathering (Passive Reconnaissance)
WHOIS Information: Domain registration and ownership details
Domain History: Reputation and historical data analysis
š 2. DNS Analysis (Infrastructure Discovery)
DNS Records Lookup: Comprehensive DNS enumeration (A, AAAA, MX, NS, TXT, SPF, DMARC)
Reverse DNS Lookup: IP to hostname resolution
Passive Subdomain Enumeration: Certificate Transparency logs discovery via crt.sh (stealth)
Active Subdomain Enumeration: DNS brute-force discovery using wordlist from subdomains.txt
š 3. Network Reconnaissance (Active Scanning)
IP Information: Geolocation, ISP, and network details
Alive Check: HTTP/HTTPS connectivity testing with response analysis
Port Scanning: Advanced Nmap integration with multiple scan modes
š 4. Web Application Analysis (Application Layer)
TLS Certificate Analysis: SSL/TLS certificate inspection and validation
HTTP Headers Analysis: Security headers assessment and information disclosure detection
Technology Detection: Web framework and technology fingerprinting
URL Extraction: Web crawling and link discovery
![]()
Related MCP server: OSINT MCP Server
š Installation
Prerequisites
Python 3.10+
UV Package Manager (automatically installed by script)
Nmap (automatically installed by script)
Quick Installation
Windows (PowerShell)
.\install.ps1Linux/macOS
chmod +x install.sh
./install.shClaude Desktop Configuration
Add this configuration to your Claude Desktop settings to connect the MCP Web Reconnaissance Server:
Windows Configuration
{
"mcpServers": {
"recon": {
"command": "C:\\Users\\YOUR_USERNAME\\.local\\bin\\uv.exe",
"args": [
"--directory",
"C:\\Users\\YOUR_USERNAME\\path\\to\\MCP_Recon",
"run",
"python",
"main.py"
]
}
}
}Linux/macOS Configuration
{
"mcpServers": {
"recon": {
"command": "/home/YOUR_USERNAME/.local/bin/uv",
"args": [
"--directory",
"/home/YOUR_USERNAME/path/to/MCP_Recon",
"run",
"python",
"main.py"
]
}
}
}Replace the following placeholders:
YOUR_USERNAMEwith your actual usernamepath/to/MCP_Reconwith the actual path to your cloned repository
Configuration file locations:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
![]()
š Usage
Available Tools (Following Reconnaissance Methodology)
1. Information Gathering (Passive Reconnaissance)
whois_info- Get WHOIS informationdomain_history- Check domain reputation and history
2. DNS Analysis (Infrastructure Discovery)
dns_records- Get all DNS records for a domainreverse_dns- Perform reverse DNS lookupsubdomain_enum_passive- Passive subdomain discovery via Certificate Transparency (crt.sh)subdomain_enum_active- Active subdomain enumeration using DNS brute force
3. Network Reconnaissance (Active Scanning)
ip_information- Get comprehensive IP informationcheck_alive- Check if hosts respond via HTTP/HTTPSport_scan- Advanced port scanning with Nmap
4. Web Application Analysis (Application Layer)
tls_certificate- Analyze TLS certificateshttp_headers- Analyze HTTP security headersdetect_technologies- Detect web technologiesextract_urls- Extract URLs from web pages
![]()
š§ Configuration
Custom User-Agent
For bug bounty programs requiring specific identification, HTTP-based tools support an optional user_agent parameter. When provided, it replaces the default User-Agent for all HTTP requests to the target.
Examples:
# Default User-Agent
http_headers("https://example.com")
# Custom User-Agent for bug bounty programs
http_headers("https://example.com", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36 bug-bounty")Tools supporting custom User-Agent:
http_headers- HTTP headers analysisdetect_technologies- Technology fingerprintingextract_urls- URL extraction/crawlingcheck_alive- Host connectivity check
![]()
š§ Wordlists
Subdomain Wordlist Customization
You can customize subdomain enumeration in two ways:
1. Edit the wordlist file
Modify the subdomains.txt file in the project root to add/remove subdomains:
www
api
admin
test
dev
staging
# Add your custom subdomains here2. Provide custom wordlist in Claude Desktop chat
Port Scanning Options
The port scanner supports various modes optimized for different scenarios:
"common": Common services (21,22,23,25,53,80,443,etc.)"top100": Top 100 most common ports (recommended for initial reconnaissance)"top1000": Top 1000 ports (comprehensive discovery)"80,443,8080": Specific ports (targeted scanning)"1-1000": Port range (internal network scanning)
![]()
š Architecture
Project Structure
mcp-recon/
āāā main.py # MCP server entry point with organized tool categories
āāā subdomains.txt # Default subdomain wordlist (customizable)
āāā tools/
ā āāā info_tools.py # Information gathering utilities (WHOIS, domain history)
ā āāā dns_tools.py # DNS and domain reconnaissance
ā āāā network_tools.py # Network scanning and analysis
ā āāā web_tools.py # Web application analysis
āāā install.ps1 # Windows installation script
āāā install.sh # Linux/macOS installation script
āāā pyproject.toml # Python project configuration
āāā README.md # This documentation![]()
š License
This project is licensed under the MIT License - see the LICENSE file for details.
![]()
ā ļø Disclaimer
This tool is intended for legitimate security research, penetration testing, and bug bounty activities only. Users are responsible for ensuring they have proper authorization before scanning or testing any networks, systems, or applications. The authors are not responsible for any misuse of this tool.
Always follow responsible disclosure practices and respect scope limitations in bug bounty programs.
Available Tools
13 toolscheck_aliveA
Check if targets are alive using HTTP/HTTPS connectivity testing.
Args: targets: List of target domains/URLs user_agent: Optional custom User-Agent string
Example: check_alive(["example.com", "test.com"]) check_alive(["example.com"], "Mozilla/5.0... bug-bounty")
Inputs: targets (required), user_agent.
detect_technologiesB
Detect technologies, frameworks, and libraries used by a website.
Args: url: Target URL user_agent: Optional custom User-Agent string
Example: detect_technologies("https://example.com") detect_technologies("https://example.com", "Mozilla/5.0... bug-bounty")
Inputs: url (required), user_agent.
dns_recordsA
Perform comprehensive DNS lookups for all record types Example: dns_records("example.com")
Inputs: domain (required).
domain_historyC
Check domain history and reputation indicators Example: domain_history("example.com")
Inputs: domain (required).
extract_urlsA
Extract all URLs from a website using Python web crawler.
Args: url: Target URL depth: Crawl depth (default: 2) user_agent: Optional custom User-Agent string
Example: extract_urls("https://example.com") extract_urls("https://example.com", 2, "Mozilla/5.0... bug-bounty")
Inputs: url (required), depth, user_agent.
http_headersB
Analyze HTTP headers for security and information disclosure.
Args: url: Target URL to analyze user_agent: Optional custom User-Agent string
Example: http_headers("https://example.com") http_headers("https://example.com", "Mozilla/5.0... bug-bounty")
Inputs: url (required), user_agent.
ip_informationA
Get comprehensive IP information including geolocation Example: ip_information("example.com") or ip_information("1.1.1.1")
Inputs: target (required).
port_scanA
Advanced port scan using nmap Ports options: "common", "top100", "top1000", "80,443,8080", "1-1000" Example: port_scan("example.com", "top100")
Inputs: target (required), ports.
reverse_dnsA
Perform reverse DNS lookup on IP address Example: reverse_dns("8.8.8.8")
Inputs: ip (required).
subdomain_enum_activeB
Enumerate subdomains using DNS brute force (active reconnaissance) Can use default wordlist from subdomains.txt file or custom wordlist provided Example: subdomain_enum_active("example.com") or subdomain_enum_active("example.com", ["www", "api", "admin"])
Inputs: domain (required), wordlist.
subdomain_enum_passiveA
Passive subdomain enumeration using Certificate Transparency logs Non-intrusive reconnaissance that doesn't generate logs on target servers Example: subdomain_enum_passive("example.com")
Inputs: domain (required).
tls_certificateC
Check TLS certificate details and security using Python SSL Example: tls_certificate("example.com")
Inputs: domain (required).
whois_infoB
Get comprehensive WHOIS information for a domain Example: whois_info("example.com")
Inputs: domain (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 13 tools
Each tool targets a distinct aspect of reconnaissance (WHOIS, DNS, subdomains, IP, ports, TLS, headers, tech detection, URL extraction), with clear descriptions preventing overlap. The active/passive subdomain tools are differentiated by method.
All tool names follow a consistent snake_case verb_noun pattern (e.g., whois_info, dns_records, port_scan, detect_technologies), with no mixing of conventions or vague verbs.
13 tools is well-scoped for a reconnaissance server, covering essential operations without being overwhelming. Each tool serves a clear purpose and earns its place.
The tool set covers all major reconnaissance areas (domain, DNS, subdomains, IP, network, TLS, HTTP, technology) with both active and passive methods. Minor gaps like email harvesting or web screenshot are not essential for a general-purpose recon server.
Maintenance
Related MCP Connectors
Cybersecurity MCP server for URL scanning, threat intelligence, and domain reputation.
MCP server: static security scanner for MCP servers, agent skills & plugins. 17 attack patterns.
MCP server for ScanMalware.com URL scanning, malware detection, and analysis.
MCP tools for agents: web research, content extraction, email, DNS, and blockchain intelligence.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server to perform various OSINT tasks by leveraging common network reconnaissance tools.48-
- AlicenseDqualityDmaintenanceA comprehensive MCP server providing tools for IP, domain, email, and image-based open-source intelligence. It integrates services like Shodan, VirusTotal, and HaveIBeenPwned to facilitate advanced security research and data gathering.56MIT

operant-mcpofficial
AlicenseAqualityDmaintenanceA comprehensive security testing MCP server providing 51 tools for penetration testing, network forensics, memory analysis, and vulnerability assessment. It enables automated security audits and technical investigations across web applications, cloud environments, and network captures.5127MIT- AlicenseAqualityBmaintenanceAn MCP server that provides passive and low-impact active reconnaissance tools for authorized bug bounty and security assessments, enabling LLMs to perform structured recon and generate reports.11Apache 2.0