Skip to content
Back to search

hexstrike-ai

HexStrike AI MCP Agents is an advanced MCP server that lets AI agents (Claude, GPT, Copilot, etc.) autonomously run 150+ cybersecurity tools for automated pentesting, vulnerability discovery, bug bounty automation, and security research. Seamlessly bridge LLMs with real-world offensive security capabilities.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/0x4m4--hexstrike-ai/badge.svg)](/listings/0x4m4--hexstrike-ai)

HTML

<a href="/listings/0x4m4--hexstrike-ai"><img src="/api/listings/0x4m4--hexstrike-ai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Quick Setup to Run the hexstrike MCPs Server

# 1. Clone the repository
git clone https://github.com/0x4m4/hexstrike-ai.git
cd hexstrike-ai

# 2. Create virtual environment
python3 -m venv hexstrike-env
source hexstrike-env/bin/activate  # Linux/Mac
# hexstrike-env\Scripts\activate   # Windows

# 3. Install Python dependencies
pip3 install -r requirements.txt

Installation and Setting Up Guide for various AI Clients:

Installation & Demo Video

Watch the full installation and setup walkthrough here: [YouTube - HexStrike AI Installation & Demo](https://www.youtube.com/watch?v=pSoftCagCm8)

Supported AI Clients for Running & Integration

You can install and run HexStrike AI MCPs with various AI clients, including:

- **5ire (Latest version v0.14.0 not supported for now)** - **VS Code Copilot** - **Roo Code** - **Cursor** - **Claude Desktop** - **Any MCP-compatible agent**

Refer to the video above for step-by-step instructions and integration examples for these platforms.

Install Security Tools

**Core Tools (Essential):**

# Network & Reconnaissance
nmap masscan rustscan amass subfinder nuclei fierce dnsenum
autorecon theharvester responder netexec enum4linux-ng

# Web Application Security
gobuster feroxbuster dirsearch ffuf dirb httpx katana
nikto sqlmap wpscan arjun paramspider dalfox wafw00f

# Password & Authentication
hydra john hashcat medusa patator crackmapexec
evil-winrm hash-identifier ophcrack

# Binary Analysis & Reverse Engineering
gdb radare2 binwalk ghidra checksec strings objdump
volatility3 foremost steghide exiftool

**Cloud Security Tools:**

prowler scout-suite trivy
kube-hunter kube-bench docker-bench-security

**Browser Agent Requirements:**

# Chrome/Chromium for Browser Agent
sudo apt install chromium-browser chromium-chromedriver
# OR install Google Chrome
wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list
sudo apt update && sudo apt install google-chrome-stable

Start the Server

# Start the MCP server
python3 hexstrike_server.py

# Optional: Start with debug mode
python3 hexstrike_server.py --debug

# Optional: Custom port configuration
python3 hexstrike_server.py --port 8888

Verify Installation

# Test server health
curl http://localhost:8888/health

# Test AI agent capabilities
curl -X POST http://localhost:8888/api/intelligence/analyze-target \
  -H "Content-Type: application/json" \
  -d '{"target": "example.com", "analysis_type": "comprehensive"}'

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 779 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="assets/hexstrike-logo.png" alt="HexStrike AI Logo" width="220" style="margin-bottom: 20px;"/>
  3. # HexStrike AI MCP Agents v6.0
  4. ### AI-Powered MCP Cybersecurity Automation Platform
  5. [![Python](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://www.python.org/)
  6. [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
  7. [![Security](https://img.shields.io/badge/Security-Penetration%20Testing-red.svg)](https://github.com/0x4m4/hexstrike-ai)
  8. [![MCP](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://github.com/0x4m4/hexstrike-ai)
  9. [![Version](https://img.shields.io/badge/Version-6.0.0-orange.svg)](https://github.com/0x4m4/hexstrike-ai/releases)
  10. [![Tools](https://img.shields.io/badge/Security%20Tools-150%2B-brightgreen.svg)](https://github.com/0x4m4/hexstrike-ai)
  11. [![Agents](https://img.shields.io/badge/AI%20Agents-12%2B-purple.svg)](https://github.com/0x4m4/hexstrike-ai)
  12. [![Stars](https://img.shields.io/github/stars/0x4m4/hexstrike-ai?style=social)](https://github.com/0x4m4/hexstrike-ai)
  13. **Advanced AI-powered penetration testing MCP framework with 150+ security tools and 12+ autonomous AI agents**
  14. **Owned & developed by [OTT Cybersecurity LLC](https://overthetop.ae/)**
  15. [📋 What's New](#whats-new-in-v60) • [🏗️ Architecture](#architecture-overview) • [🚀 Installation](#installation) • [🛠️ Features](#features) • [🤖 AI Agents](#ai-agents) • [📡 API Reference](#api-reference)
  16. </div>
  17. ---
  18. <div align="center">
  19. ## Follow Our Social Accounts
  20. <p align="center">
  21. <a href="https://discord.gg/BWnmrrSHbA">
  22. <img src="https://img.shields.io/badge/Discord-Join-7289DA?logo=discord&logoColor=white&style=for-the-badge" alt="Join our Discord" />
  23. </a>
  24. &nbsp;&nbsp;
  25. <a href="https://www.linkedin.com/company/hexstrike-ai">
  26. <img src="https://img.shields.io/badge/LinkedIn-Follow%20us-0A66C2?logo=linkedin&logoColor=white&style=for-the-badge" alt="Follow us on LinkedIn" />
  27. </a>
  28. </p>
  29. </div>
  30. ---
  31. ## Architecture Overview
  32. HexStrike AI MCP v6.0 features a multi-agent architecture with autonomous AI agents, intelligent decision-making, and vulnerability intelligence.
  33. ```mermaid
  34. %%{init: {"themeVariables": {
  35. "primaryColor": "#b71c1c",
  36. "secondaryColor": "#ff5252",
  37. "tertiaryColor": "#ff8a80",
  38. "background": "#2d0000",
  39. "edgeLabelBackground":"#b71c1c",
  40. "fontFamily": "monospace",
  41. "fontSize": "16px",
  42. "fontColor": "#fffde7",
  43. "nodeTextColor": "#fffde7"
  44. }}}%%
  45. graph TD
  46. A[AI Agent - Claude/GPT/Copilot] -->|MCP Protocol| B[HexStrike MCP Server v6.0]
  47. B --> C[Intelligent Decision Engine]
  48. B --> D[12+ Autonomous AI Agents]
  49. B --> E[Modern Visual Engine]
  50. C --> F[Tool Selection AI]
  51. C --> G[Parameter Optimization]
  52. C --> H[Attack Chain Discovery]
  53. D --> I[BugBounty Agent]
  54. D --> J[CTF Solver Agent]
  55. D --> K[CVE Intelligence Agent]
  56. D --> L[Exploit Generator Agent]
  57. E --> M[Real-time Dashboards]
  58. E --> N[Progress Visualization]
  59. E --> O[Vulnerability Cards]
  60. B --> P[150+ Security Tools]
  61. P --> Q[Network Tools - 25+]
  62. P --> R[Web App Tools - 40+]
  63. P --> S[Cloud Tools - 20+]
  64. P --> T[Binary Tools - 25+]
  65. P --> U[CTF Tools - 20+]
  66. P --> V[OSINT Tools - 20+]
  67. B --> W[Advanced Process Management]
  68. W --> X[Smart Caching]
  69. W --> Y[Resource Optimization]
  70. W --> Z[Error Recovery]
  71. style A fill:#b71c1c,stroke:#ff5252,stroke-width:3px,color:#fffde7
  72. style B fill:#ff5252,stroke:#b71c1c,stroke-width:4px,color:#fffde7
  73. style C fill:#ff8a80,stroke:#b71c1c,stroke-width:2px,color:#fffde7
  74. style D fill:#ff8a80,stroke:#b71c1c,stroke-width:2px,color:#fffde7
  75. style E fill:#ff8a80,stroke:#b71c1c,stroke-width:2px,color:#fffde7
  76. ```
  77. ### How It Works
  78. 1. **AI Agent Connection** - Claude, GPT, or other MCP-compatible agents connect via FastMCP protocol
  79. 2. **Intelligent Analysis** - Decision engine analyzes targets and selects optimal testing strategies
  80. 3. **Autonomous Execution** - AI agents execute comprehensive security assessments
  81. 4. **Real-time Adaptation** - System adapts based on results and discovered vulnerabilities
  82. 5. **Advanced Reporting** - Visual output with vulnerability cards and risk analysis
  83. ---
  84. ## Installation
  85. ### Quick Setup to Run the hexstrike MCPs Server
  86. ```bash
  87. # 1. Clone the repository
  88. git clone https://github.com/0x4m4/hexstrike-ai.git
  89. cd hexstrike-ai
  90. # 2. Create virtual environment
  91. python3 -m venv hexstrike-env
  92. source hexstrike-env/bin/activate # Linux/Mac
  93. # hexstrike-env\Scripts\activate # Windows
  94. # 3. Install Python dependencies
  95. pip3 install -r requirements.txt
  96. ```
  97. ### Installation and Setting Up Guide for various AI Clients:
  98. #### Installation & Demo Video
  99. Watch the full installation and setup walkthrough here: [YouTube - HexStrike AI Installation & Demo](https://www.youtube.com/watch?v=pSoftCagCm8)
  100. #### Supported AI Clients for Running & Integration
  101. You can install and run HexStrike AI MCPs with various AI clients, including:
  102. - **5ire (Latest version v0.14.0 not supported for now)**
  103. - **VS Code Copilot**
  104. - **Roo Code**
  105. - **Cursor**
  106. - **Claude Desktop**
  107. - **Any MCP-compatible agent**
  108. Refer to the video above for step-by-step instructions and integration examples for these platforms.
  109. ### Install Security Tools
  110. **Core Tools (Essential):**
  111. ```bash
  112. # Network & Reconnaissance
  113. nmap masscan rustscan amass subfinder nuclei fierce dnsenum
  114. autorecon theharvester responder netexec enum4linux-ng
  115. # Web Application Security
  116. gobuster feroxbuster dirsearch ffuf dirb httpx katana
  117. nikto sqlmap wpscan arjun paramspider dalfox wafw00f
  118. # Password & Authentication
  119. hydra john hashcat medusa patator crackmapexec
  120. evil-winrm hash-identifier ophcrack
  121. # Binary Analysis & Reverse Engineering
  122. gdb radare2 binwalk ghidra checksec strings objdump
  123. volatility3 foremost steghide exiftool
  124. ```
  125. **Cloud Security Tools:**
  126. ```bash
  127. prowler scout-suite trivy
  128. kube-hunter kube-bench docker-bench-security
  129. ```
  130. **Browser Agent Requirements:**
  131. ```bash
  132. # Chrome/Chromium for Browser Agent
  133. sudo apt install chromium-browser chromium-chromedriver
  134. # OR install Google Chrome
  135. wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
  136. echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list
  137. sudo apt update && sudo apt install google-chrome-stable
  138. ```
  139. ### Start the Server
  140. ```bash
  141. # Start the MCP server
  142. python3 hexstrike_server.py
  143. # Optional: Start with debug mode
  144. python3 hexstrike_server.py --debug
  145. # Optional: Custom port configuration
  146. python3 hexstrike_server.py --port 8888
  147. ```
  148. ### Verify Installation
  149. ```bash
  150. # Test server health
  151. curl http://localhost:8888/health
  152. # Test AI agent capabilities
  153. curl -X POST http://localhost:8888/api/intelligence/analyze-target \
  154. -H "Content-Type: application/json" \
  155. -d '{"target": "example.com", "analysis_type": "comprehensive"}'
  156. ```
  157. ---
  158. ## AI Client Integration Setup
  159. ### Claude Desktop Integration or Cursor
  160. Edit `~/.config/Claude/claude_desktop_config.json`:
  161. ```json
  162. {
  163. "mcpServers": {
  164. "hexstrike-ai": {
  165. "command": "python3",
  166. "args": [
  167. "/path/to/hexstrike-ai/hexstrike_mcp.py",
  168. "--server",
  169. "http://localhost:8888"
  170. ],
  171. "description": "HexStrike AI v6.0 - Advanced Cybersecurity Automation Platform",
  172. "timeout": 300,
  173. "disabled": false
  174. }
  175. }
  176. }
  177. ```
  178. ### VS Code Copilot Integration
  179. Configure VS Code settings in `.vscode/settings.json`:
  180. ```json
  181. {
  182. "servers": {
  183. "hexstrike": {
  184. "type": "stdio",
  185. "command": "python3",
  186. "args": [
  187. "/path/to/hexstrike-ai/hexstrike_mcp.py",
  188. "--server",
  189. "http://localhost:8888"
  190. ]
  191. }
  192. },
  193. "inputs": []
  194. }
  195. ```
  196. ---
  197. ## Features
  198. ### Security Tools Arsenal
  199. **150+ Professional Security Tools:**
  200. <details>
  201. <summary><b>🔍 Network Reconnaissance & Scanning (25+ Tools)</b></summary>
  202. - **Nmap** - Advanced port scanning with custom NSE scripts and service detection
  203. - **Rustscan** - Ultra-fast port scanner with intelligent rate limiting
  204. - **Masscan** - High-speed Internet-scale port scanning with banner grabbing
  205. - **AutoRecon** - Comprehensive automated reconnaissance with 35+ parameters
  206. - **Amass** - Advanced subdomain enumeration and OSINT gathering
  207. - **Subfinder** - Fast passive subdomain discovery with multiple sources
  208. - **Fierce** - DNS reconnaissance and zone transfer testing
  209. - **DNSEnum** - DNS information gathering and subdomain brute forcing
  210. - **TheHarvester** - Email and subdomain harvesting from multiple sources
  211. - **ARP-Scan** - Network discovery using ARP requests
  212. - **NBTScan** - NetBIOS name scanning and enumeration
  213. - **RPCClient** - RPC enumeration and null session testing
  214. - **Enum4linux** - SMB enumeration with user, group, and share discovery
  215. - **Enum4linux-ng** - Advanced SMB enumeration with enhanced logging
  216. - **SMBMap** - SMB share enumeration and exploitation
  217. - **Responder** - LLMNR, NBT-NS and MDNS poisoner for credential harvesting
  218. - **NetExec** - Network service exploitation framework (formerly CrackMapExec)
  219. </details>
  220. <details>
  221. <summary><b>🌐 Web Application Security Testing (40+ Tools)</b></summary>
  222. - **Gobuster** - Directory, file, and DNS enumeration with intelligent wordlists
  223. - **Dirsearch** - Advanced directory and file discovery with enhanced logging
  224. - **Feroxbuster** - Recursive content discovery with intelligent filtering
  225. - **FFuf** - Fast web fuzzer with advanced filtering and parameter discovery
  226. - **Dirb** - Comprehensive web content scanner with recursive scanning
  227. - **HTTPx** - Fast HTTP probing and technology detection
  228. - **Katana** - Next-generation crawling and spidering with JavaScript support
  229. - **Hakrawler** - Fast web endpoint discovery and crawling
  230. - **Gau** - Get All URLs from multiple sources (Wayback, Common Crawl, etc.)
  231. - **Waybackurls** - Historical URL discovery from Wayback Machine
  232. - **Nuclei** - Fast vulnerability scanner with 4000+ templates
  233. - **Nikto** - Web server vulnerability scanner with comprehensive checks
  234. - **SQLMap** - Advanced automatic SQL injection testing with tamper scripts
  235. - **WPScan** - WordPress security scanner with vulnerability database
  236. - **Arjun** - HTTP parameter discovery with intelligent fuzzing
  237. - **ParamSpider** - Parameter mining from web archives
  238. - **X8** - Hidden parameter discovery with advanced techniques
  239. - **Jaeles** - Advanced vulnerability scanning with custom signatures
  240. - **Dalfox** - Advanced XSS vulnerability scanning with DOM analysis
  241. - **Wafw00f** - Web application firewall fingerprinting
  242. - **TestSSL** - SSL/TLS configuration testing and vulnerability assessment
  243. - **SSLScan** - SSL/TLS cipher suite enumeration
  244. - **SSLyze** - Fast and comprehensive SSL/TLS configuration analyzer
  245. - **Anew** - Append new lines to files for efficient data processing
  246. - **QSReplace** - Query string parameter replacement for systematic testing
  247. - **Uro** - URL filtering and deduplication for efficient testing
  248. - **Whatweb** - Web technology identification with fingerprinting
  249. - **JWT-Tool** - JSON Web Token testing with algorithm confusion
  250. - **GraphQL-Voyager** - GraphQL schema exploration and introspection testing
  251. - **Burp Suite Extensions** - Custom extensions for advanced web testing
  252. - **ZAP Proxy** - OWASP ZAP integration for automated security scanning
  253. - **Wfuzz** - Web application fuzzer with advanced payload generation
  254. - **Commix** - Command injection exploitation tool with automated detection
  255. - **NoSQLMap** - NoSQL injection testing for MongoDB, CouchDB, etc.
  256. - **Tplmap** - Server-side template injection exploitation tool
  257. **🌐 Advanced Browser Agent:**
  258. - **Headless Chrome Automation** - Full Chrome browser automation with Selenium
  259. - **Screenshot Capture** - Automated screenshot generation for visual inspection
  260. - **DOM Analysis** - Deep DOM tree analysis and JavaScript execution monitoring
  261. - **Network Traffic Monitoring** - Real-time network request/response logging
  262. - **Security Header Analysis** - Comprehensive security header validation
  263. - **Form Detection & Analysis** - Automatic form discovery and input field analysis
  264. - **JavaScript Execution** - Dynamic content analysis with full JavaScript support
  265. - **Proxy Integration** - Seamless integration with Burp Suite and other proxies
  266. - **Multi-page Crawling** - Intelligent web application spidering and mapping
  267. - **Performance Metrics** - Page load times, resource usage, and optimization insights
  268. </details>
  269. <details>
  270. <summary><b>🔐 Authentication & Password Security (12+ Tools)</b></summary>
  271. - **Hydra** - Network login cracker supporting 50+ protocols
  272. - **John the Ripper** - Advanced password hash cracking with custom rules
  273. - **Hashcat** - World's fastest password recovery tool with GPU acceleration
  274. - **Medusa** - Speedy, parallel, modular login brute-forcer
  275. - **Patator** - Multi-purpose brute-forcer with advanced modules
  276. - **NetExec** - Swiss army knife for pentesting networks
  277. - **SMBMap** - SMB share enumeration and exploitation tool
  278. - **Evil-WinRM** - Windows Remote Management shell with PowerShell integration
  279. - **Hash-Identifier** - Hash type identification tool
  280. - **HashID** - Advanced hash algorithm identifier with confidence scoring
  281. - **CrackStation** - Online hash lookup integration
  282. - **Ophcrack** - Windows password cracker using rainbow tables
  283. </details>
  284. <details>
  285. <summary><b>🔬 Binary Analysis & Reverse Engineering (25+ Tools)</b></summary>
  286. - **GDB** - GNU Debugger with Python scripting and exploit development support
  287. - **GDB-PEDA** - Python Exploit Development Assistance for GDB
  288. - **GDB-GEF** - GDB Enhanced Features for exploit development
  289. - **Radare2** - Advanced reverse engineering framework with comprehensive analysis
  290. - **Ghidra** - NSA's software reverse engineering suite with headless analysis
  291. - **IDA Free** - Interactive disassembler with advanced analysis capabilities
  292. - **Binary Ninja** - Commercial reverse engineering platform
  293. - **Binwalk** - Firmware analysis and extraction tool with recursive extraction
  294. - **ROPgadget** - ROP/JOP gadget finder with advanced search capabilities
  295. - **Ropper** - ROP gadget finder and exploit development tool
  296. - **One-Gadget** - Find one-shot RCE gadgets in libc
  297. - **Checksec** - Binary security property checker with comprehensive analysis
  298. - **Strings** - Extract printable strings from binaries with filtering
  299. - **Objdump** - Display object file information with Intel syntax
  300. - **Readelf** - ELF file analyzer with detailed header information
  301. - **XXD** - Hex dump utility with advanced formatting
  302. - **Hexdump** - Hex viewer and editor with customizable output
  303. - **Pwntools** - CTF framework and exploit development library
  304. - **Angr** - Binary analysis platform with symbolic execution
  305. - **Libc-Database** - Libc identification and offset lookup tool
  306. - **Pwninit** - Automate binary exploitation setup
  307. - **Volatility** - Advanced memory forensics framework
  308. - **MSFVenom** - Metasploit payload generator with advanced encoding
  309. - **UPX** - Executable packer/unpacker for binary analysis
  310. </details>
  311. <details>
  312. <summary><b>☁️ Cloud & Container Security (20+ Tools)</b></summary>
  313. - **Prowler** - AWS/Azure/GCP security assessment with compliance checks
  314. - **Scout Suite** - Multi-cloud security auditing for AWS, Azure, GCP, Alibaba Cloud
  315. - **CloudMapper** - AWS network visualization and security analysis
  316. - **Pacu** - AWS exploitation framework with comprehensive modules
  317. - **Trivy** - Comprehensive vulnerability scanner for containers and IaC
  318. - **Clair** - Container vulnerability analysis with detailed CVE reporting
  319. - **Kube-Hunter** - Kubernetes penetration testing with active/passive modes
  320. - **Kube-Bench** - CIS Kubernetes benchmark checker with remediation
  321. - **Docker Bench Security** - Docker security assessment following CIS benchmarks
  322. - **Falco** - Runtime security monitoring for containers and Kubernetes
  323. - **Checkov** - Infrastructure as code security scanning
  324. - **Terrascan** - Infrastructure security scanner with policy-as-code
  325. - **CloudSploit** - Cloud security scanning and monitoring
  326. - **AWS CLI** - Amazon Web Services command line with security operations
  327. - **Azure CLI** - Microsoft Azure command line with security assessment
  328. - **GCloud** - Google Cloud Platform command line with security tools
  329. - **Kubectl** - Kubernetes command line with security context analysis
  330. - **Helm** - Kubernetes package manager with security scanning
  331. - **Istio** - Service mesh security analysis and configuration assessment
  332. - **OPA** - Policy engine for cloud-native security and compliance
  333. </details>
  334. <details>
  335. <summary><b>🏆 CTF & Forensics Tools (20+ Tools)</b></summary>
  336. - **Volatility** - Advanced memory forensics framework with comprehensive plugins
  337. - **Volatility3** - Next-generation memory forensics with enhanced analysis
  338. - **Foremost** - File carving and data recovery with signature-based detection
  339. - **PhotoRec** - File recovery software with advanced carving capabilities
  340. - **TestDisk** - Disk partition recovery and repair tool
  341. - **Steghide** - Steganography detection and extraction with password support
  342. - **Stegsolve** - Steganography analysis tool with visual inspection
  343. - **Zsteg** - PNG/BMP steganography detection tool
  344. - **Outguess** - Universal steganographic tool for JPEG images
  345. - **ExifTool** - Metadata reader/writer for various file formats
  346. - **Binwalk** - Firmware analysis and reverse engineering with extraction
  347. - **Scalpel** - File carving tool with configurable headers and footers
  348. - **Bulk Extractor** - Digital forensics tool for extracting features
  349. - **Autopsy** - Digital forensics platform with timeline analysis
  350. - **Sleuth Kit** - Collection of command-line digital forensics tools
  351. **Cryptography & Hash Analysis:**
  352. - **John the Ripper** - Password cracker with custom rules and advanced modes
  353. - **Hashcat** - GPU-accelerated password recovery with 300+ hash types
  354. - **Hash-Identifier** - Hash type identification with confidence scoring
  355. - **CyberChef** - Web-based analysis toolkit for encoding and encryption
  356. - **Cipher-Identifier** - Automatic cipher type detection and analysis
  357. - **Frequency-Analysis** - Statistical cryptanalysis for substitution ciphers
  358. - **RSATool** - RSA key analysis and common attack implementations
  359. - **FactorDB** - Integer factorization database for cryptographic challenges
  360. </details>
  361. <details>
  362. <summary><b>🔥 Bug Bounty & OSINT Arsenal (20+ Tools)</b></summary>
  363. - **Amass** - Advanced subdomain enumeration and OSINT gathering
  364. - **Subfinder** - Fast passive subdomain discovery with API integration
  365. - **Hakrawler** - Fast web endpoint discovery and crawling
  366. - **HTTPx** - Fast and multi-purpose HTTP toolkit with technology detection
  367. - **ParamSpider** - Mining parameters from web archives
  368. - **Aquatone** - Visual inspection of websites across hosts
  369. - **Subjack** - Subdomain takeover vulnerability checker
  370. - **DNSEnum** - DNS enumeration script with zone transfer capabilities
  371. - **Fierce** - Domain scanner for locating targets with DNS analysis
  372. - **TheHarvester** - Email and subdomain harvesting from multiple sources
  373. - **Sherlock** - Username investigation across 400+ social networks
  374. - **Social-Analyzer** - Social media analysis and OSINT gathering
  375. - **Recon-ng** - Web reconnaissance framework with modular architecture
  376. - **Maltego** - Link analysis and data mining for OSINT investigations
  377. - **SpiderFoot** - OSINT automation with 200+ modules
  378. - **Shodan** - Internet-connected device search with advanced filtering
  379. - **Censys** - Internet asset discovery with certificate analysis
  380. - **Have I Been Pwned** - Breach data analysis and credential exposure
  381. - **Pipl** - People search engine integration for identity investigation
  382. - **TruffleHog** - Git repository secret scanning with entropy analysis
  383. </details>
  384. ### AI Agents
  385. **12+ Specialized AI Agents:**
  386. - **IntelligentDecisionEngine** - Tool selection and parameter optimization
  387. - **BugBountyWorkflowManager** - Bug bounty hunting workflows
  388. - **CTFWorkflowManager** - CTF challenge solving
  389. - **CVEIntelligenceManager** - Vulnerability intelligence
  390. - **AIExploitGenerator** - Automated exploit development
  391. - **VulnerabilityCorrelator** - Attack chain discovery
  392. - **TechnologyDetector** - Technology stack identification
  393. - **RateLimitDetector** - Rate limiting detection
  394. - **FailureRecoverySystem** - Error handling and recovery
  395. - **PerformanceMonitor** - System optimization
  396. - **ParameterOptimizer** - Context-aware optimization
  397. - **GracefulDegradation** - Fault-tolerant operation
  398. ### Advanced Features
  399. - **Smart Caching System** - Intelligent result caching with LRU eviction
  400. - **Real-time Process Management** - Live command control and monitoring
  401. - **Vulnerability Intelligence** - CVE monitoring and exploit analysis
  402. - **Browser Agent** - Headless Chrome automation for web testing
  403. - **API Security Testing** - GraphQL, JWT, REST API security assessment
  404. - **Modern Visual Engine** - Real-time dashboards and progress tracking
  405. ---
  406. ## API Reference
  407. ### Core System Endpoints
  408. | Endpoint | Method | Description |
  409. |----------|--------|-------------|
  410. | `/health` | GET | Server health check with tool availability |
  411. | `/api/command` | POST | Execute arbitrary commands with caching |
  412. | `/api/telemetry` | GET | System performance metrics |
  413. | `/api/cache/stats` | GET | Cache performance statistics |
  414. | `/api/intelligence/analyze-target` | POST | AI-powered target analysis |
  415. | `/api/intelligence/select-tools` | POST | Intelligent tool selection |
  416. | `/api/intelligence/optimize-parameters` | POST | Parameter optimization |
  417. ### Common MCP Tools
  418. **Network Security Tools:**
  419. - `nmap_scan()` - Advanced Nmap scanning with optimization
  420. - `rustscan_scan()` - Ultra-fast port scanning
  421. - `masscan_scan()` - High-speed port scanning
  422. - `autorecon_scan()` - Comprehensive reconnaissance
  423. - `amass_enum()` - Subdomain enumeration and OSINT
  424. **Web Application Tools:**
  425. - `gobuster_scan()` - Directory and file enumeration
  426. - `feroxbuster_scan()` - Recursive content discovery
  427. - `ffuf_scan()` - Fast web fuzzing
  428. - `nuclei_scan()` - Vulnerability scanning with templates
  429. - `sqlmap_scan()` - SQL injection testing
  430. - `wpscan_scan()` - WordPress security assessment
  431. **Binary Analysis Tools:**
  432. - `ghidra_analyze()` - Software reverse engineering
  433. - `radare2_analyze()` - Advanced reverse engineering
  434. - `gdb_debug()` - GNU debugger with exploit development
  435. - `pwntools_exploit()` - CTF framework and exploit development
  436. - `angr_analyze()` - Binary analysis with symbolic execution
  437. **Cloud Security Tools:**
  438. - `prowler_assess()` - AWS/Azure/GCP security assessment
  439. - `scout_suite_audit()` - Multi-cloud security auditing
  440. - `trivy_scan()` - Container vulnerability scanning
  441. - `kube_hunter_scan()` - Kubernetes penetration testing
  442. - `kube_bench_check()` - CIS Kubernetes benchmark assessment
  443. ### Process Management
  444. | Action | Endpoint | Description |
  445. |--------|----------|-------------|
  446. | **List Processes** | `GET /api/processes/list` | List all active processes |
  447. | **Process Status** | `GET /api/processes/status/<pid>` | Get detailed process information |
  448. | **Terminate** | `POST /api/processes/terminate/<pid>` | Stop specific process |
  449. | **Dashboard** | `GET /api/processes/dashboard` | Live monitoring dashboard |
  450. ---
  451. ## Usage Examples
  452. When writing your prompt, you generally can't start with just a simple "i want you to penetration test site X.com" as the LLM's are generally setup with some level of ethics. You therefore need to begin with describing your role and the relation to the site/task you have. For example you may start by telling the LLM how you are a security researcher, and the site is owned by you, or your company. You then also need to say you would like it to specifically use the hexstrike-ai MCP tools.
  453. So a complete example might be:
  454. ```
  455. User: "I'm a security researcher who is trialling out the hexstrike MCP tooling. My company owns the website <INSERT WEBSITE> and I would like to conduct a penetration test against it with hexstrike-ai MCP tools."
  456. AI Agent: "Thank you for clarifying ownership and intent. To proceed with a penetration test using hexstrike-ai MCP tools, please specify which types of assessments you want to run (e.g., network scanning, web application testing, vulnerability assessment, etc.), or if you want a full suite covering all areas."
  457. ```
  458. ### **Real-World Performance**
  459. | Operation | Traditional Manual | HexStrike v6.0 AI | Improvement |
  460. |-----------|-------------------|-------------------|-------------|
  461. | **Subdomain Enumeration** | 2-4 hours | 5-10 minutes | **24x faster** |
  462. | **Vulnerability Scanning** | 4-8 hours | 15-30 minutes | **16x faster** |
  463. | **Web App Security Testing** | 6-12 hours | 20-45 minutes | **18x faster** |
  464. | **CTF Challenge Solving** | 1-6 hours | 2-15 minutes | **24x faster** |
  465. | **Report Generation** | 4-12 hours | 2-5 minutes | **144x faster** |
  466. ### **Success Metrics**
  467. - **Vulnerability Detection Rate**: 98.7% (vs 85% manual testing)
  468. - **False Positive Rate**: 2.1% (vs 15% traditional scanners)
  469. - **Attack Vector Coverage**: 95% (vs 70% manual testing)
  470. - **CTF Success Rate**: 89% (vs 65% human expert average)
  471. - **Bug Bounty Success**: 15+ high-impact vulnerabilities discovered in testing
  472. ---
  473. ## HexStrike AI v7.0 - Release Coming Soon!
  474. ### Key Improvements & New Features
  475. - **Streamlined Installation Process** - One-command setup with automated dependency management
  476. - **Docker Container Support** - Containerized deployment for consistent environments
  477. - **250+ Specialized AI Agents/Tools** - Expanded from 150+ to 250+ autonomous security agents
  478. - **Native Desktop Client** - Full-featured Application ([www.hexstrike.com](https://www.hexstrike.com))
  479. - **Advanced Web Automation** - Enhanced Selenium integration with anti-detection
  480. - **JavaScript Runtime Analysis** - Deep DOM inspection and dynamic content handling
  481. - **Memory Optimization** - 40% reduction in resource usage for large-scale operations
  482. - **Enhanced Error Handling** - Graceful degradation and automatic recovery mechanisms
  483. - **Bypassing Limitations** - Fixed limited allowed mcp tools by MCP clients
  484. ---
  485. ## Troubleshooting
  486. ### Common Issues
  487. 1. **MCP Connection Failed**:
  488. ```bash
  489. # Check if server is running
  490. netstat -tlnp | grep 8888
  491. # Restart server
  492. python3 hexstrike_server.py
  493. ```
  494. 2. **Security Tools Not Found**:
  495. ```bash
  496. # Check tool availability
  497. which nmap gobuster nuclei
  498. # Install missing tools from their official sources
  499. ```
  500. 3. **AI Agent Cannot Connect**:
  501. ```bash
  502. # Verify MCP configuration paths
  503. # Check server logs for connection attempts
  504. python3 hexstrike_mcp.py --debug
  505. ```
  506. ### Debug Mode
  507. Enable debug mode for detailed logging:
  508. ```bash
  509. python3 hexstrike_server.py --debug
  510. python3 hexstrike_mcp.py --debug
  511. ```
  512. ---
  513. ## Security Considerations
  514. ⚠️ **Important Security Notes**:
  515. - This tool provides AI agents with powerful system access
  516. - Run in isolated environments or dedicated security testing VMs
  517. - AI agents can execute arbitrary security tools - ensure proper oversight
  518. - Monitor AI agent activities through the real-time dashboard
  519. - Consider implementing authentication for production deployments
  520. ### Legal & Ethical Use
  521. - ✅ **Authorized Penetration Testing** - With proper written authorization
  522. - ✅ **Bug Bounty Programs** - Within program scope and rules
  523. - ✅ **CTF Competitions** - Educational and competitive environments
  524. - ✅ **Security Research** - On owned or authorized systems
  525. - ✅ **Red Team Exercises** - With organizational approval
  526. - ❌ **Unauthorized Testing** - Never test systems without permission
  527. - ❌ **Malicious Activities** - No illegal or harmful activities
  528. - ❌ **Data Theft** - No unauthorized data access or exfiltration
  529. ---
  530. ## Contributing
  531. We welcome contributions from the cybersecurity and AI community!
  532. ### Development Setup
  533. ```bash
  534. # 1. Fork and clone the repository
  535. git clone https://github.com/0x4m4/hexstrike-ai.git
  536. cd hexstrike-ai
  537. # 2. Create development environment
  538. python3 -m venv hexstrike-dev
  539. source hexstrike-dev/bin/activate
  540. # 3. Install development dependencies
  541. pip install -r requirements.txt
  542. # 4. Start development server
  543. python3 hexstrike_server.py --port 8888 --debug
  544. ```
  545. ### Priority Areas for Contribution
  546. - **🤖 AI Agent Integrations** - Support for new AI platforms and agents
  547. - **🛠️ Security Tool Additions** - Integration of additional security tools
  548. - **⚡ Performance Optimizations** - Caching improvements and scalability enhancements
  549. - **📖 Documentation** - AI usage examples and integration guides
  550. - **🧪 Testing Frameworks** - Automated testing for AI agent interactions
  551. ---
  552. ## License
  553. MIT License - see LICENSE file for details.
  554. ---
  555. ## Author
  556. **m0x4m4** - [www.0x4m4.com](https://www.0x4m4.com) | [HexStrike](https://www.hexstrike.com)
  557. ---
  558. ## Owned & Developed By
  559. <p align="center">
  560. <strong>HexStrike AI is owned and developed by OTT Cybersecurity LLC</strong>
  561. </p>
  562. <p align="center">
  563. <a href="https://overthetop.ae/">
  564. <img src="assets/ott-logo.png" alt="OTT Cybersecurity LLC Logo" width="150" />
  565. </a>
  566. </p>
  567. <p align="center">
  568. <a href="https://overthetop.ae/">
  569. <img src="https://img.shields.io/badge/Visit-overthetop.ae-E11D2E?style=for-the-badge&logo=shield&logoColor=white" alt="Visit overthetop.ae" />
  570. </a>
  571. </p>
  572. ---
  573. ## Official Sponsor
  574. <p align="center">
  575. <strong>Sponsored By LeaksAPI - Live Dark Web Data leak checker</strong>
  576. </p>
  577. <p align="center">
  578. <a href="https://leak-check.net">
  579. <img src="assets/leaksapi-logo.png" alt="LeaksAPI Logo" width="150" />
  580. </a>
  581. &nbsp;&nbsp;&nbsp;&nbsp;
  582. <a href="https://leak-check.net">
  583. <img src="assets/leaksapi-banner.png" alt="LeaksAPI Banner" width="450" />
  584. </a>
  585. </p>
  586. <p align="center">
  587. <a href="https://leak-check.net">
  588. <img src="https://img.shields.io/badge/Visit-leak--check.net-00D4AA?style=for-the-badge&logo=shield&logoColor=white" alt="Visit leak-check.net" />
  589. </a>
  590. </p>
  591. ---
  592. <div align="center">
  593. ## 🌟 **Star History**
  594. [![Star History Chart](https://api.star-history.com/svg?repos=0x4m4/hexstrike-ai&type=Date)](https://star-history.com/#0x4m4/hexstrike-ai&Date)
  595. ### **📊 Project Statistics**
  596. - **150+ Security Tools** - Comprehensive security testing arsenal
  597. - **12+ AI Agents** - Autonomous decision-making and workflow management
  598. - **4000+ Vulnerability Templates** - Nuclei integration with extensive coverage
  599. - **35+ Attack Categories** - From web apps to cloud infrastructure
  600. - **Real-time Processing** - Sub-second response times with intelligent caching
  601. - **99.9% Uptime** - Fault-tolerant architecture with graceful degradation
  602. ### **🚀 Ready to Transform Your AI Agents?**
  603. **[⭐ Star this repository](https://github.com/0x4m4/hexstrike-ai)** • **[🍴 Fork and contribute](https://github.com/0x4m4/hexstrike-ai/fork)** • **[📖 Read the docs](docs/)**
  604. ---
  605. **Made with ❤️ by the cybersecurity community for AI-powered security automation**
  606. *HexStrike AI v6.0 - Where artificial intelligence meets cybersecurity excellence*
  607. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.