# Hunter — how to use (mcp.ai)

Connect your Hunter account and use 26 tools for email straight from your AI agent. Connect with your own API key. Hunter is an email marketing company specializing in lead generation and data enrichment.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hunter?ms=1787293740000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `hunter_account_information`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hunter`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/hunter/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hunter/account/information` — Tool to retrieve information about your Hunter account. Use when you need to check your plan details and usage limits after confirming credentials. Returns `searches.available` and `verifications.avai
- `POST https://api.mcp.ai/api/hunter/combined/enrichment` — Tool to find both person and company information from an email address or LinkedIn handle in a single request. Use when you need complete professional profile enrichment including employment and compa
  - body: { email?: string, linkedin?: string }
- `POST https://api.mcp.ai/api/hunter/company/enrichment` — Tool to get enrichment information for a company by its domain. Use when you need full company details (industry, description, location, metrics) from Hunter.
  - body: { domain: string, clearbit_format?: string }
- `POST https://api.mcp.ai/api/hunter/create/custom/attribute` — Tool to create a new custom lead attribute in your account. Use after deciding on the attribute label.
  - body: { label: string }
- `POST https://api.mcp.ai/api/hunter/create/lead` — Tool to create a new lead. Use after gathering all prospect details to save them to your Hunter account.
  - body: { email: string, notes?: string, source?: string, company?: string, twitter?: string, website?: string, position?: string, last_name?: string, first_name?: string, company_size?: string, country_code?: string, linkedin_url?: string, phone_number?: string, leads_list_id?: integer, leads_list_ids?: integer[], company_industry?: string, confidence_score?: integer, custom_attributes?: object }
- `POST https://api.mcp.ai/api/hunter/create/leads/list` — Tool to create a new leads list. Use when you need to organize leads into a custom list before adding leads.
  - body: { name: string }
- `POST https://api.mcp.ai/api/hunter/delete/custom/attribute` — Tool to delete an existing custom attribute. Use after confirming the attribute ID to be removed.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/hunter/delete/lead` — Tool to delete a lead. Use after confirming the lead's ID to remove it from your Hunter.io account.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/hunter/delete/leads/list` — Tool to delete a leads list by its ID. Use after confirming the leads list ID to remove it from your Hunter.io account.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/hunter/discover/companies` — Tool to search and retrieve companies matching specified criteria using filters or natural language queries. Use when you need to discover companies from Hunter's B2B dataset based on industry, locati
  - body: { limit?: integer, query?: string, offset?: integer, headcount?: string[], funding_series?: string[], keywords_match?: string, funding_date_to?: string, similar_to_name?: string, year_founded_to?: integer, industry_exclude?: string[], industry_include?: string[], keywords_exclude?: string[], keywords_include?: string[], technology_match?: string, funding_amount_to?: number, funding_date_from?: string, organization_name?: string[], similar_to_domain?: string, year_founded_from?: integer, technology_exclude?: string[], technology_include?: string[], funding_amount_from?: number, organization_domain?: string[], company_type_exclude?: string[], company_type_include?: string[], year_founded_include?: integer[], headquarters_location_exclude?: string[], headquarters_location_include?: string[] }
- `POST https://api.mcp.ai/api/hunter/domain/search` — Tool to search all email addresses for a given domain or company. Use when you need public emails and metadata for outreach or enrichment. Rate-limited; HTTP 429 returned on excess requests — honor th
  - body: { type?: string, limit?: integer, domain?: string, offset?: integer, company?: string, seniority?: string[], department?: string[], required_field?: string[] }
- `POST https://api.mcp.ai/api/hunter/email/count` — Tool to get the total number of email addresses Hunter has for a domain or company with breakdowns by type, department, and seniority. Use when you need email volume statistics without consuming API c
  - body: { type?: string, domain?: string, company?: string }
- `POST https://api.mcp.ai/api/hunter/email/finder` — Tool to find the most likely email address for a person at a domain or company. Use when you have a person's name and a domain or company and need to infer their email. Results include a confidence sc
  - body: { domain?: string, company?: string, full_name?: string, last_name?: string, first_name?: string, max_duration?: integer }
- `POST https://api.mcp.ai/api/hunter/email/verifier` — Tool to verify the deliverability of an email address. Use when you need to ensure an address is valid and reachable. Response may include statuses `accept_all` or `risky`, indicating uncertain delive
  - body: { email: string }
- `POST https://api.mcp.ai/api/hunter/get/custom/attribute` — Tool to retrieve details of a specific custom attribute. Use when you need the label and slug for an attribute ID.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/hunter/get/lead` — Tool to retrieve details of a specific lead by ID. Use after confirming the lead's ID to fetch its full record.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/hunter/get/leads/list` — Tool to retrieve details of a specific leads list by ID. Use when you need to inspect the contents of an existing leads list.
  - body: { id: integer, limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/hunter/list/campaigns` — Tool to get all email campaigns in your Hunter account. Campaigns are returned in reverse-chronological order by creation date. Use when you need to retrieve and filter campaigns by status (started/ar
  - body: { limit?: integer, offset?: integer, started?: boolean, archived?: boolean }
- `POST https://api.mcp.ai/api/hunter/list/custom/attributes` — Tool to list all custom lead attributes in your account. Use when you need to retrieve your account's custom lead attributes after authenticating.
- `POST https://api.mcp.ai/api/hunter/list/leads` — Tool to list all leads saved in your account with optional filters. Use when you need to retrieve leads with specific criteria after confirming your API key.
  - body: { email?: string, limit?: integer, query?: string, offset?: integer, company?: string, twitter?: string, website?: string, position?: string, last_name?: string, created_at?: string, first_name?: string, country_code?: string, linkedin_url?: string, phone_number?: string, leads_list_id?: integer, last_activity_at?: string, custom_attributes?: string[], last_contacted_at?: string, max_confidence_score?: integer, min_confidence_score?: integer }
- `POST https://api.mcp.ai/api/hunter/list/leads/lists` — Tool to list all leads lists in your account. Use when you need to retrieve and paginate through your leads lists.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/hunter/people/enrichment` — Tool to find all information associated with an email address or LinkedIn profile including name, location, job title and social handles. Use when you need to enrich contact data with additional perso
  - body: { email?: string, clearbit_format?: boolean, linkedin_handle?: string }
- `POST https://api.mcp.ai/api/hunter/update/custom/attribute` — Tool to update an existing custom attribute's label. Use when renaming a custom attribute after creation.
  - body: { id: integer, label: string }
- `POST https://api.mcp.ai/api/hunter/update/lead` — Tool to update details of an existing lead by ID. Use when you need to modify saved lead attributes after creation.
  - body: { id: integer, email?: string, notes?: string, source?: string, company?: string, twitter?: string, website?: string, position?: string, last_name?: string, first_name?: string, company_size?: string, country_code?: string, linkedin_url?: string, phone_number?: string, leads_list_id?: integer, leads_list_ids?: integer[], company_industry?: string, confidence_score?: integer, custom_attributes?: object }
- `POST https://api.mcp.ai/api/hunter/update/leads/list` — Tool to update the name of a specific leads list. Use when renaming an existing leads list.
  - body: { id: integer, name: string }
- `POST https://api.mcp.ai/api/hunter/upsert/lead` — Tool to create or update a lead by email in one call. Use when you want to ensure a lead exists with the provided information without checking its existence first.
  - body: { email: string, notes?: string, source?: string, company?: string, twitter?: string, website?: string, position?: string, last_name?: string, first_name?: string, company_size?: string, country_code?: string, linkedin_url?: string, phone_number?: string, leads_list_id?: integer, leads_list_ids?: integer[], company_industry?: string, confidence_score?: integer, custom_attributes?: object }

## Example prompts
- "What can I do in Hunter?"
- "Show me a summary of my Hunter account"

## More
- Page: https://mcp.ai/hunter
- Agent spec (llms.txt): https://mcp.ai/hunter/llms.txt
- Postman collection: https://mcp.ai/hunter/postman.json