# Hunter MCP

> Hunter MCP finds and validates professional email addresses for sales outreach. It lets your agent search entire domains, locate specific people by name and company, check if an address actually works (deliverability), and save all the contact intel straight into a lead database.

## Overview
- **Category:** sales-automation
- **Price:** Free
- **Tags:** email-finder, domain-search, email-verification, prospecting, lead-enrichment, deliverability

## Description

Connect this MCP to any AI client—Claude, Cursor, or whatever you use—and let your agent handle email prospecting conversations. Instead of manually guessing emails, you tell your agent what domain you're interested in, and it finds every professional address associated with that company. Need a specific person? Tell it the name and company; it figures out the best guess for their email. It even checks if that email is deliverable right now, giving you confidence scores so you know which leads are safe to use. When you need to build out your prospect list, this MCP does the heavy lifting, letting you enrich contacts with titles and social profiles, or save them directly into a managed lead list. You get access to all of this functionality through Vinkius, making it easy for any compatible client to run complex sales workflows without leaving their environment.

## Tools

### create_new_lead
Saves a validated contact record into your lead database.

### remove_lead
Deletes an entire lead record from your management system.

### search_domain_emails
Searches and lists multiple professional email addresses associated with a given domain name.

### get_domain_email_count
Counts how many total professional email addresses are available for a specific domain before searching them.

### find_person_email
Guesses the most likely personal email address based on a person's name and their employer.

### verify_email_address
Checks a single email address to confirm if it is deliverable and active right now.

### get_account_usage
Checks how many API credits you have remaining for searches or verifications.

### enrich_email_data
Retrieves full professional data, like job title and company info, for an email address.

### get_lead_details
Fetches the complete information for any lead record currently saved in your system.

### list_lead_folders
Lists all the different organizational folders or list types you've set up for your leads.

### list_saved_leads
Retrieves a full list of all lead profiles and records stored in your database.

### update_lead_info
Modifies specific data points for an existing lead record you've already saved.

## Prompt Examples

**Prompt:** 
```
Find all emails at stripe.com and verify the CTO's email address.
```

**Response:** 
```
Domain search for 'stripe.com': 48 emails available. Top results: 1) patrick@stripe.com — Patrick Collison (CEO, confidence: 95%). Sources: 4 public web pages. 2) john@stripe.com — John Collison (President, confidence: 92%). 3) david@stripe.com — David Singleton (CTO, confidence: 88%). 4) claire@stripe.com — Claire Hughes Johnson (COO, confidence: 85%). Verifying CTO email: david@stripe.com — ✅ Status: deliverable. Confidence: 92%. MX records: valid (Google Workspace). SMTP check: passed. Accept-all: no. This email is safe for outreach. Would you like to save these as leads or enrich the contacts?
```

**Prompt:** 
```
Find the email for Sarah Chen at Acme Corp and enrich her contact data.
```

**Response:** 
```
Email found! sarah.chen@acmecorp.com — Confidence: 91%. Pattern used: {first}.{last}@acmecorp.com. Enrichment data: Full name: Sarah Chen. Title: VP of Engineering. Company: Acme Corp (acmecorp.com). Industry: SaaS. Employees: 250-500. LinkedIn: linkedin.com/in/sarahchen. Twitter: @sarahchen_tech. Location: San Francisco, CA. Previous: Senior Engineer at Google (2018-2022). Lead saved! ID: lead_4521. Added to 'Enterprise Prospects' list. Would you like to verify her email or search for more contacts at Acme Corp?
```

**Prompt:** 
```
Check my Hunter account credits and list all saved leads.
```

**Response:** 
```
Account: john@company.com. Plan: Starter. Credits this month: Searches: 18 of 500 used (482 remaining). Verifications: 42 of 1,000 used (958 remaining). Resets: May 1, 2025. Saved leads: 34 total. Lead lists: 1) 'Enterprise Prospects' — 12 leads (8 verified, 4 unverified). 2) 'SMB Outreach' — 15 leads (12 verified, 3 risky). 3) 'Recruiting Pipeline' — 7 leads (all verified). Recent leads: sarah.chen@acmecorp.com (VP Engineering, added today). david@stripe.com (CTO, added today). mike@techco.com (Director Sales, added yesterday). Would you like to verify unverified leads or search a new domain?
```

## Capabilities

### Find emails by domain
Your agent searches an entire company domain and lists every professional email address associated with that organization.

### Locate person emails
The MCP takes a name and company, then finds the most likely personal email address for that specific individual.

### Verify deliverability
It checks any provided email address to confirm if it's valid, active, and safe for outreach.

### Gather contact intelligence
Your agent retrieves a full profile—including titles, companies, and social media links—for an existing email address.

### Manage lead records
You can save new leads to your database, update existing contact information, or delete old records.

## Use Cases

### Cold outreach campaign setup
A B2B marketer needs 50 emails for a new target list. They ask their agent first to use `get_domain_email_count` on the domain, then run `search_domain_emails` to gather all possible contacts. Next, they feed those into `enrich_email_data` and finally save them all using `create_new_lead`.

### Targeting a single decision-maker
A recruiter finds a company name and a VP's name. They ask the agent to run `find_person_email`. Once an email is generated, they immediately use `verify_email_address` before sharing it with the candidate.

### Cleaning up stale leads
The sales team has 100 old records. They ask the agent to run `list_saved_leads`, spot outdated contacts, and use `get_lead_details` to check if they still match current company info before updating them with `update_lead_info`.

### Checking account readiness
Before starting a big search, the SDR asks the agent to run `get_account_usage`. This confirms they have enough credits remaining for both searches and verifications, preventing workflow stoppage.

## Benefits

- Stop guessing emails. Use `verify_email_address` to check deliverability on the fly; you know your outreach efforts won't hit a bounce-back folder.
- Build massive lists quickly. Running `search_domain_emails` gives you every professional email associated with a company, not just the obvious ones.
- Avoid manual data entry. After finding an email, use `enrich_email_data` to grab job titles and social profiles in one step.
- Keep your database clean. Use tools like `list_lead_folders` and `create_new_lead` to organize every prospect into the right place immediately.
- Manage credits easily. Check your account status with `get_account_usage` so you never get stuck mid-campaign due to running out of searches.

## How It Works

The bottom line is: it turns complex email research into simple conversation commands for your AI client.

1. Subscribe to this MCP and paste your Hunter API Key into the client configuration.
2. Ask your AI agent to perform a task, like finding all emails for 'example.com' or enriching a specific contact address.
3. The MCP runs the search/verification, and your agent presents you with actionable data, such as confirmed deliverable addresses ready to save.

## Frequently Asked Questions

**How do I use the Hunter MCP to verify an email address?**
You simply ask your agent to run `verify_email_address` on the specific email. The result immediately tells you if it's deliverable and provides a confidence score, so you know if it'll make it into the inbox.

**Can I find emails for an entire company domain using Hunter MCP?**
Yes. Use `search_domain_emails` to list every professional email address associated with a full domain name, giving you a comprehensive list of contacts.

**What is the best way to save leads after finding them?**
After gathering contact info, use `create_new_lead` to save it. You can also organize those new records by first listing your folders using `list_lead_folders`.

**Does the Hunter MCP only find emails? Can it get more data?**
No, it gets much more than just emails. Use `enrich_email_data` to pull in professional context like job titles, company names, and even social media links.

**How do I check if I have enough credits for a big campaign?**
Run the `get_account_usage` tool. This reports your current usage against your plan's limits for both searches and verifications, so you can budget your efforts.

**How do I update existing records using the Hunter MCP's lead tools?**
You can modify saved contact details directly via the MCP. The `update_lead_info` tool lets you correct titles, change company names, or add new data to an established profile without having to create a whole new record.

**Can I remove old records using the Hunter MCP's lead tools?**
Yes, you can clean up your CRM data by deleting profiles. Use `remove_lead` when a stored lead is outdated or incorrect and should no longer be tracked in your list.

**How does the Hunter MCP manage my saved lead organization?**
You manage your structure using specific tools. The `list_lead_folders` tool shows all the organizational categories available, letting you see exactly where your different prospect lists are stored.

**Can I find all professional email addresses for a specific company?**
Yes. Use `search_domain_emails` with a domain (e.g., 'stripe.com') or company name (e.g., 'Stripe') to retrieve all professional emails found for that organization. Each result includes the email, confidence score, position, and source URLs. Use `get_domain_email_count` to preview how many emails are available before using search credits.

**Can I verify if an email address is valid before sending outreach?**
Yes. The `verify_email_address` tool checks the validity and deliverability of any email address. It returns a status (deliverable, undeliverable, risky, unknown), confidence score, and details about the email server (MX records, SMTP check, accept-all detection). This prevents bounces and protects your sender reputation.

**How does Hunter API authentication work?**
Hunter uses an API Key passed as a query parameter (`?api_key=YOUR_KEY`) in all requests to `api.hunter.io/v2`. This differs from the typical Bearer token pattern. Your API key is available in the Hunter dashboard under Account > API. Free accounts include 25 searches and 50 verifications per month.