BugBounty

v1.0.0Securitystable

Comprehensive MCP server for bug bounty hunting and web application penetration testing

bugbountymcpai-integration
Share:
31
Stars
0
Downloads
0
Weekly
0/5

What is BugBounty?

BugBounty is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to comprehensive mcp server for bug bounty hunting and web application penetration testing

Comprehensive MCP server for bug bounty hunting and web application penetration testing

This server falls under the Security category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Comprehensive MCP server for bug bounty hunting and web appl

Use Cases

Conduct comprehensive web application penetration testing through MCP.
Execute organized bug bounty hunting campaigns with structured tooling.
Perform security assessment across multiple attack vectors and methodologies.
gokulapap

Maintainer

LicenseNOASSERTION
Languagepython
Versionv1.0.0
UpdatedMay 11, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx bugbounty

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use BugBounty

The BugBounty MCP Server is a comprehensive Python-based security platform that gives AI assistants access to 92+ penetration testing tools across eight categories including reconnaissance, vulnerability assessment, exploitation, and reporting. It integrates with industry-standard tools like nmap, nuclei, sqlmap, subfinder, and httpx, allowing you to conduct structured bug bounty campaigns and web application security assessments through natural language commands. Designed for authorized security testing, it includes safeguards like target whitelisting, rate limiting, and audit logging to ensure responsible use.

Prerequisites

  • Python 3.10+ (3.11+ recommended) installed on macOS, Linux, or WSL
  • External security tools installed: nmap, masscan, nikto, sqlmap, nuclei, subfinder, httpx, gobuster, ffuf
  • Optional API keys: SHODAN_API_KEY, VIRUSTOTAL_API_KEY, CENSYS_API_ID/SECRET, GITHUB_TOKEN, SECURITYTRAILS_API_KEY
  • Docker and docker-compose (for the recommended Docker installation method)
  • An MCP client such as Claude Desktop, and explicit authorization to test any target systems
1

Clone the repository

Clone the BugBounty MCP Server repository from GitHub to your local machine.

git clone https://github.com/gokulapap/bugbounty-mcp-server.git
cd bugbounty-mcp-server
2

Install via Docker (recommended)

Build and start the server using Docker Compose. This is the recommended method as it bundles all security tool dependencies.

docker-compose up --build -d
3

Configure environment variables

Copy the example env file and fill in your API keys for optional integrations like Shodan, VirusTotal, Censys, and GitHub. Only the keys you provide will enable those integrations.

cp env.example .env
# Edit .env and add your API keys:
# SHODAN_API_KEY=your_key
# VIRUSTOTAL_API_KEY=your_key
# CENSYS_API_ID=your_id
# CENSYS_API_SECRET=your_secret
# GITHUB_TOKEN=your_token
# SECURITYTRAILS_API_KEY=your_key
4

Configure Claude Desktop

Add the server configuration to your Claude Desktop config file. This uses the Docker exec method to connect to the running container.

{
  "mcpServers": {
    "bugbounty-mcp": {
      "command": "docker",
      "args": ["exec", "-i", "bugbounty-mcp-server", "bugbounty-mcp", "serve"]
    }
  }
}
5

Verify the server is running

Check that the Docker container is up and the server is healthy before attempting connections from your MCP client.

docker-compose ps
docker logs bugbounty-mcp-server

BugBounty Examples

Client configuration

Claude Desktop configuration using the Docker-based deployment. Replace the container name if you customized docker-compose.yml.

{
  "mcpServers": {
    "bugbounty-mcp": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "bugbounty-mcp-server",
        "bugbounty-mcp",
        "serve"
      ]
    }
  }
}

Prompts to try

Example prompts to use after connecting the server. Always ensure you have explicit authorization before testing any target.

- "Enumerate all subdomains for example.com using subfinder and httpx"
- "Run a comprehensive port scan on 192.168.1.1 and identify running services"
- "Test the login endpoint at https://example.com/login for SQL injection vulnerabilities"
- "Search GitHub for exposed credentials related to example.com"
- "Generate a vulnerability report summarizing findings from today's assessment"

Troubleshooting BugBounty

Docker container exits immediately or crashes on startup

Check logs with 'docker logs bugbounty-mcp-server'. Ensure docker-compose.yml is present and not modified. Try rebuilding with 'docker-compose up --build' to ensure the image is fresh.

External tools like nmap or nuclei are not found

If using native installation instead of Docker, install each tool separately. On macOS use Homebrew (e.g. 'brew install nmap'), on Ubuntu use apt (e.g. 'apt install nmap'). Nuclei and subfinder need to be installed from their GitHub releases or via 'go install'.

API key integrations like Shodan or VirusTotal return errors

Verify the .env file is in the project root and the variable names match exactly (SHODAN_API_KEY, VIRUSTOTAL_API_KEY, etc.). Restart the Docker container after editing .env with 'docker-compose restart'.

Frequently Asked Questions about BugBounty

What is BugBounty?

BugBounty is a Model Context Protocol (MCP) server that comprehensive mcp server for bug bounty hunting and web application penetration testing It connects AI assistants to external tools and data sources through a standardized interface.

How do I install BugBounty?

Follow the installation instructions on the BugBounty GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with BugBounty?

BugBounty works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is BugBounty free to use?

Yes, BugBounty is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.

BugBounty Alternatives — Similar Security Servers

Looking for alternatives to BugBounty? Here are other popular security servers you can use with Claude, Cursor, and VS Code.

Casdoor

13.6k

An open-source Agent-first Identity and Access Management (IAM) /LLM MCP & agent gateway and auth server with web UI supporting OpenClaw, MCP, OAuth, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, Face ID, Google Workspace, Azure AD

ghidraMCP

9.0k

An Model Context Protocol server that enables LLMs to autonomously reverse engineer applications by exposing Ghidra's decompilation and analysis tools. It allows AI agents to list code structures, rename methods, and analyze binaries directly through

HexStrike AI

8.9k

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 b

IDA Pro MCP

8.7k

Enables AI-assisted reverse engineering in IDA Pro by providing tools to analyze binaries, decompile functions, manage comments, search patterns, and interact with the IDA database through natural language.

Anthropic Cybersecurity Skills

6.6k

754 structured cybersecurity skills for AI agents · Mapped to 5 frameworks: MITRE ATT&CK, NIST CSF 2.0, MITRE ATLAS, D3FEND & NIST AI RMF · agentskills.io standard · Works with Claude Code, GitHub Copilot, Codex CLI, Cursor, Gemini CLI & 20+ platform

Hooker

5.1k

🔥🔥 hooker is a Frida-based reverse engineering toolkit for Android. It offers a user-friendly CLI, universal scripts, auto hook generation, memory roaming to detect activities/services, one-click SOCKS5 proxy setup, Frida JustTrustMe, and BoringSSL u

Browse More Security MCP Servers

Explore all security servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "bugbounty": { "command": "npx", "args": ["-y", "bugbounty"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use BugBounty?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides