Summary
Connects Claude and other MCP clients to HeroHunt's people search API covering 1 billion profiles across LinkedIn, GitHub, and StackOverflow. You get natural language search via the people_search tool, pagination for result sets, and enrichment options for email and phone data. Also exposes account management tools for checking credits, listing past searches, and rotating API keys. Ships with both remote HTTP endpoint support and stdio transport via npx. Useful when you need to query professional profiles programmatically or build AI workflows that involve candidate research and talent discovery. Requires a HeroHunt API key and uses a credit system per search.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →herohunt-mcp
MCP server for the HeroHunt People Search API. Search for talent across LinkedIn, GitHub, and StackOverflow from any MCP-compatible AI agent.
Quick Start
Option 1: Remote URL (recommended)
Claude Desktop, Cursor, and most modern MCP clients support remote HTTP endpoints directly. No package installation needed.
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"herohunt-people-search": {
"url": "https://api.herohunt.ai/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"herohunt-people-search": {
"url": "https://api.herohunt.ai/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Option 2: stdio (via npx)
For MCP clients that only support stdio transport:
{
"mcpServers": {
"herohunt-people-search": {
"command": "npx",
"args": ["-y", "herohunt-mcp"],
"env": {
"HEROHUNT_API_KEY": "YOUR_API_KEY"
}
}
}
}
Get Your API Key
Sign up at herohunt.ai/app/api/sign-up to get your API key.
Tools
| Tool | Type | Description |
|---|---|---|
people_search | Write | Search for people profiles using natural language. 1 credit per reserved slot. |
people_search_paginate | Read | Fetch more results for an existing search. Free unless enrichment is on. |
account_usage_get | Read | Get plan, credits, rate limit info. Free. |
account_searches_list | Read | List past searches. Free. |
account_upgrade_link | Read | Get plan upgrade URL. Free. |
account_billing_portal_link | Read | Get Stripe billing portal URL. Free. |
api_keys_list | Read | List API key prefixes and scopes. Free. |
api_keys_create | Write | Create a new API key. |
api_keys_rotate | Write | Rotate an existing API key. |
api_keys_revoke | Write | Permanently revoke an API key. |
Example
After connecting, ask your AI agent:
"Use HeroHunt to find me 5 senior Go engineers in Berlin and summarise the top 3."
The agent will call people_search with a natural language query, receive structured profile data (name, title, company, location, skills, platform links), and summarize the results.
To get contact info, ask:
"Enrich the results with emails and phone numbers."
The agent will call people_search_paginate with enrich: true.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
HEROHUNT_API_KEY | Yes | - | Your People Search API key |
HEROHUNT_MCP_URL | No | https://api.herohunt.ai/api/v1/mcp | Override the MCP endpoint URL |
Links
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
HEROHUNT_API_KEY*secretHeroHunt API key. Get one at https://www.herohunt.ai/app/api/sign-up
Registryactive
Packageherohunt-mcp
TransportSTDIO
AuthRequired
UpdatedMay 11, 2026
