Hunter Automation

Power your outreach with Hunter.io -- discover email addresses by domain, find specific people's emails, verify deliverability, save leads, and track your API usage -- all through natural language commands.

Toolkit docs: claude-skills.ai/toolkits/hunter

Setup

1. Add the Claude Skill MCP server to your client configuration:

   https://rube.app/mcp
   

2. Connect your Hunter.io account when prompted (API key authentication).
3. Start issuing natural language commands to find and verify emails.

Core Workflows

1. Search Domain for Email Addresses

Discover all publicly available email addresses for a given domain or company, with filtering by department, seniority, and type.

Tool:

HUNTER_DOMAIN_SEARCH

Example prompt:

"Find all executive email addresses at stripe.com using Hunter"

Key parameters:

• domain

  -- Domain to search (e.g., "stripe.com"). Required if

  company

  not provided.

• company

  -- Company name to search (e.g., "Stripe"). Required if

  domain

  not provided.

• type

  -- Filter by "personal" or "generic" emails

• seniority

  -- Filter by levels: "junior", "senior", "executive" (array)

• department

  -- Filter by departments: "executive", "it", "finance", "sales", etc. (array)

• required_field

  -- Require specific fields: "full_name", "position", "phone_number" (array)

• limit

  -- Max results per request (1-100, default 10; free/basic plans limited to 10)

• offset

  -- Skip results for pagination (default 0)

2. Find a Specific Person's Email

Infer the most likely email address for a person given their name and domain or company.

Tool:

HUNTER_EMAIL_FINDER

Example prompt:

"Find the email for Alexis Ohanian at reddit.com using Hunter"

Key parameters:

• domain

  -- Target domain (e.g., "reddit.com"). Takes precedence over

  company

  .

• company

  -- Company name (e.g., "Reddit"). Used if domain not provided.
• Name (one of these combinations required):

  • first_name

    +

    last_name

    (e.g., "Alexis" + "Ohanian")

  • full_name

    (e.g., "Alexis Ohanian")

• max_duration

  -- Max request duration in seconds (3-20, default 10). Longer durations yield more accurate results.

3. Verify Email Deliverability

Check whether an email address is valid, deliverable, and safe to send to.

Tool:

HUNTER_EMAIL_VERIFIER

Example prompt:

"Verify if john.doe@example.com is a valid email address"

Key parameters:

• email

  (required) -- The email address to verify (e.g., "john.doe@example.com")

Response includes: verification status, deliverability score, MX record validation, and risk assessment.

4. Get Email Volume Estimates

Check how many email addresses Hunter has for a domain or company -- this call is free and does not consume API credits.

Tool:

HUNTER_EMAIL_COUNT

Example prompt:

"How many email addresses does Hunter have for stripe.com?"

Key parameters:

• domain

  -- Domain to query (e.g., "stripe.com"). Required if

  company

  not provided.

• company

  -- Company name (min 3 characters). Required if

  domain

  not provided.

• type

  -- Filter count by "personal" or "generic" emails

Returns: Total count with breakdowns by type, department, and seniority level.

5. Save and Manage Leads

Create or update leads by email in a single upsert call -- no need to check existence first.

Tool:

HUNTER_UPSERT_LEAD

Example prompt:

"Save john@stripe.com as a lead in Hunter with name John Doe, position CTO"

Key parameters:

• email

  -- Lead's email address (primary identifier for upsert)
• Name, position, company, and other lead metadata

6. Check Account Usage and Limits

Review your Hunter account plan details, remaining searches, and verification quotas before running bulk operations.

Tool:

HUNTER_ACCOUNT_INFORMATION

Example prompt:

"How many Hunter API searches do I have left this month?"

Key parameters: None required.

Known Pitfalls

• HTTP 401 means invalid credentials:

  authentication_failed

  errors indicate an invalid or expired API key. Fix before attempting bulk operations.
• Email counts are estimates:

  HUNTER_EMAIL_COUNT

  returns approximate numbers for sizing and prioritization, not guaranteed retrievable email counts.
• Domain search uses offset pagination:

  HUNTER_DOMAIN_SEARCH

  paginates via

  limit

  /

  offset

  . Do not assume the first page is complete -- continue fetching until results are empty or you hit a cap.
• Empty results are not errors:

  HUNTER_DOMAIN_SEARCH

  can return

  emails: []

  with no error. Treat as "no data found" and continue, rather than retrying as a failure.
• Verification status nuances:

  accept_all

  or

  risky

  statuses from

  HUNTER_EMAIL_VERIFIER

  indicate uncertainty. Exclude these from strict deliverability workflows or handle them separately.
• Free/basic plan limits: Free and basic plans limit

  HUNTER_DOMAIN_SEARCH

  to 10 results per request. Higher limits require a paid plan.
• Domain format matters: Use bare domains like "stripe.com" -- do not include protocol ("https://") or "www." prefix.

Quick Reference

HUNTER_DOMAIN_SEARCH

domain

company

HUNTER_EMAIL_FINDER

domain

company

HUNTER_EMAIL_VERIFIER

email

HUNTER_EMAIL_COUNT

domain

company

HUNTER_UPSERT_LEAD

email

HUNTER_ACCOUNT_INFORMATION

Part of the Claude Skills Hub