
---

##  `README.md`

```markdown
# mscope — OSINT tool for discovering emails by username

`mscope` is a command-line tool that generates and checks possible email addresses based on provided usernames and domain patterns. It is designed for OSINT investigations and recon purposes.

---

##  Features

- Email generation using templates and domains
- DNS-based MX record validation
- SMTP-based email verification (non-intrusive)
- Multi-threaded scanning
- Simple CLI interface
- Fully customizable domain/pattern lists

---

##  Installation

### Via pip:

```bash
pip install mscope

mscope