Bug Bounty MCP Server

Instructions

Implementation Reference

• src/mcp_server/app.py:368-401 (handler)

  The handler function for the 'subfinder_scan' MCP tool. It collects parameters, sends a POST request to the backend API endpoint '/api/subfinder', and returns the results with logging.

  @mcp.tool()
  def subfinder_scan(
      domain: str,
      silent: bool = True,
      all_sources: bool = False,
      additional_args: str = "",
  ) -> dict[str, Any]:
      """Execute Subfinder for passive subdomain enumeration with enhanced logging.
  
      Args:
          domain: Target domain
          silent: Run in silent mode
          all_sources: Use all sources
          additional_args: Additional Subfinder arguments
  
      Returns:
          Passive subdomain enumeration results
      """
      data = {
          "domain": domain,
          "silent": silent,
          "all_sources": all_sources,
          "additional_args": additional_args,
      }
  
      logger.info(f"🔍 Starting Subfinder passive enumeration for {domain}")
      result = api_client.safe_post("api/subfinder", data)
  
      if result.get("success"):
          logger.info(f"✅ Subfinder enumeration completed for {domain}")
      else:
          logger.error("❌ Subfinder enumeration failed")
  
      return result