⚠️ ARCHIVED — Merged into outreachmagic/outreachmagic. Install the consolidated skill instead:

npx skills add outreachmagic/outreachmagic

This is a read-only mirror. Stars, issues, and pull requests belong at outreachmagic/outreachmagic.

Email Waterfall Finder

Find work emails when you have a name and company domain. Or verify emails you already have through MillionVerifier or deep verification through Scrubby. Works standalone with just API keys, or pairs with Outreach Magic to save every result and never search for the same lead twice.

Part of the Outreach Magic skill suite.

How it fits

Two ways to use this skill. They are separate. You pick the one you need.

Path 1: Find emails with the waterfall. Give it a name and domain (one off or a whole list). Enable trykitt, Icypeas, or both. The waterfall hits the first enabled platform. No match? Falls back to the next one. If it finds an email, it saves to local agent storage. If Outreach Magic is connected, it saves there instead.

                      ┌────────────────────┐
name + domain ───────►│   email finder     │
(single or list)      └─────────┬──────────┘
                                │
                   ┌────────────▼────────────┐       hit
                   │  trykitt (if enabled)   ├────────────────┐
                   └────────────┬────────────┘                │
                                │ miss                        │
                   ┌────────────▼────────────┐       hit      │
                   │  Icypeas (if enabled)   ├──────────────┐ │
                   └────────────┬────────────┘              │ │
                                │ miss                      │ │
                   ┌────────────▼────────────┐              │ │
                   │  no email found         │              │ │
                   └─────────────────────────┘              │ │
                                                            ▼ ▼
                                                   ┌──────────────────┐
                                                   │   email found    │
                                                   └────────┬─────────┘
                                                            │
                                            ┌───────────────┴───────────────┐
                                            ▼                               ▼
                                  ┌──────────────────┐          ┌──────────────────┐
                                  │  agent replies   │          │  OM database     │
                                  │  (not saved)     │          │  (if connected)  │
                                  └──────────────────┘          └──────────────────┘

Path 2: Verify emails you already have. Got a list of emails you collected somewhere else? Run them through MillionVerifier for instant deliverability checks, or Scrubby for deeper catch-all/unknown detection (24-72 hour turnaround). You do not need trykitt or Icypeas for this. These paths do not connect back to the waterfall.

                ┌──────────────────┐
 email list ───►│  MillionVerifier │──► instant check
                └──────────────────┘
                ┌──────────────────┐
 email list ───►│  Scrubby         │──► deep verify (24-72h)
                └──────────────────┘

Mode	What happens	What you need
Standalone find	Hits trykitt (if enabled), falls back to Icypeas (if enabled), saves result locally	One or more API keys (trykitt, Icypeas, or both)
Standalone verify (instant)	Checks emails you already have for deliverability	MillionVerifier API key
Deep verify (catch-all)	Submits emails for 24-72 hour deep verification	Scrubby API key
With Outreach Magic	Same waterfall, but saves to your pipeline and skips leads you already searched	OM account + API keys

Quick start

Once it's installed, try prompts like these:

find the email for bill smith at acmecorp.com using trykitt only

find emails for everyone in leads.csv

verify these emails: bill@acme.com, jane@xyz.io

Not sure what it can do? Ask your agent:

tell me everything the email finder skill can do

Install

You can install just the email finder skill on its own. Or install the full Outreach Magic suite, which gives you the email finder, the local database, and lead enrichment all at once.

Install just the email finder:

npx skills add outreachmagic/email-finder

Install the full Outreach Magic suite (email finder + database + lead enrich):

npx skills add outreachmagic/outreachmagic

Or follow the agent install guide: AGENTS-INSTALL.md

What you need

Key	For	Required?
TRYKITT_API_KEY	Find emails via trykitt.ai	One or the other, not both
ICYPEAS_API_KEY	Fallback find via Icypeas	One or the other, not both
MILLIONVERIFIER_API_KEY	Instant deliverability check	Only for verify paths
SCRUBBY_API_KEY	Deep verification (24-72h, catch-all detection)	Only for verify paths
Outreach Magic login	Dedup and save results to pipeline	Only with OM

Set your API keys in your agent's environment config. If you use Outreach Magic, you can set them in the portal instead and they get passed through automatically.

License

MIT. Outreach Magic