Huntr exposes an HTTP MCP server at https://api.tryhuntr.com/mcp. Once connected, your AI assistant gets the full Huntr API as tools — research, list building, enrichment, and page operations — not just /research.
Every paid REST endpoint (except signup webhooks) is available as an MCP tool:
| MCP tool | REST equivalent | What it does |
|---|
research | POST /research | Agent-led research — account briefs, buyer research, structured answers |
company_search | POST /company-search | Build company lists with structured filters |
company_search_count | POST /company-search-count | Preview list size (free) |
person_search | POST /person-search | Find people by title, employer, skills, location |
person_search_count | POST /person-search-count | Preview people match count (free) |
person_email | POST /person-email | Find a work email for one person |
person_linkedin | POST /person-linkedin | Full LinkedIn profile from URL |
person_linkedin_url | POST /person-linkedin-url | Resolve LinkedIn profile URL from name + company |
linkedin_company | POST /company-linkedin | Company profile from LinkedIn URL |
company_linkedin_url | POST /company-linkedin-url | Resolve LinkedIn company URL from domain |
tech_stack | POST /company-tech-stack | Detect technologies on a domain |
company_contact | POST /company-contact | Emails, phones, socials from company website |
job_postings | POST /company-jobs | Active job listings |
find_pages | POST /page-find | Discover relevant URLs on a domain |
page_scrape | POST /page-scrape | Scrape structured content from one URL |
page_analyze | POST /page-analyze | LLM analysis of one page |
get_pricing | GET /pricing | Full pricing matrix (no charge) |
get_balance | GET /balance | Remaining credits (no charge) |
get_usage | GET /usage | Recent request history (no charge) |
Agents should call direct tools (person_email, company_search, tech_stack, …) for known lookups. Use research only when the task needs cross-source synthesis on one target.
Cursor
- Open Cursor → Settings → MCP → Add new global MCP server (edits
~/.cursor/mcp.json)
- Add:
{
"mcpServers": {
"huntr": {
"type": "http",
"url": "https://api.tryhuntr.com/mcp",
"headers": { "x-api-key": "hntr_YOUR_KEY" }
}
}
}
- Restart Cursor. Use Agent mode.
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"huntr": {
"type": "http",
"url": "https://api.tryhuntr.com/mcp",
"headers": { "x-api-key": "hntr_YOUR_KEY" }
}
}
}
Claude Code (CLI)
claude mcp add huntr --transport http https://api.tryhuntr.com/mcp \
-H "x-api-key: hntr_YOUR_KEY"
/mcp in a session to verify connection.
Codex
Add to ~/.codex/config.toml:
[mcp_servers.huntr]
url = "https://api.tryhuntr.com/mcp"
[mcp_servers.huntr.headers]
x-api-key = "hntr_YOUR_KEY"
Example prompts
Research (one target)
- “Use Huntr to research Notion’s enterprise motion and who owns security buying decisions.”
Search + enrich (multi-step)
- “Search for VP Engineering contacts at linear.app, then find a work email for the best match.”
- “Preview how many US SaaS companies have 50–200 employees, then fetch the first page.”
Direct enrichment
- “Get stripe.com’s tech stack and open job postings using Huntr.”
- “Scrape https://linear.app/pricing and summarize the pricing tiers.”
Meta
- “What’s my Huntr balance and the price of a standard research request?”
Tips
- Call
get_pricing before paid tools so the agent picks the right tier and knows costs.
- For bulk lists, chain
company_search_count → company_search → person_search → person_email — do not loop research.
- Get your API key from the dashboard.
Next step
