HeroHunt.ai MCP (People Search API)
About
People search API - find 1 billion candidates across LinkedIn and GitHub with real-time data. Search with natural language, enrich profiles with verified emails and phone numbers. Works with Claude, Cursor, ChatGPT Desktop, and any MCP-compatible AI agent.
Details
- Author
- herohunt-ai
- Downloads
- 329
- Categories
- Developer Tools, Search
Jump to
- Search across LinkedIn, GitHub, and StackOverflow from one API
- Natural language queries for candidate discovery
- Enrich results with emails and phone numbers
- Paginate through search results without extra credits
- View account usage, plan, and rate limits for free
- Manage API keys programmatically
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
HeroHunt.ai MCP (People Search API)Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the server in your MCP client using either a remote URL (recommended) or stdio via npx. Provide your HeroHunt API key as an environment variable or header. Then ask your AI agent to perform searches using natural language queries. The server exposes tools such as people_search, people_search_paginate, and several account and API key management tools.
people_search
Search for people profiles using natural language across LinkedIn, GitHub, and StackOverflow. Credits: 1 per reserved slot up front (default maxResults=100). Enrichment: +1 credit per LinkedIn profile with contact info.
people_search_paginate
Fetch additional pages for an existing search. Free unless enrich is enabled.
account_usage_get
Get plan, total/used/remaining credits, rate limit, and next credit reset date. Free.
account_searches_list
List past searches with first-page profiles. Free.
account_upgrade_link
Get a dashboard URL prefilled with account email for plan upgrades. Free.
account_billing_portal_link
Get Stripe Customer Portal URL for managing subscriptions. Free.
api_keys_list
List API key prefixes, scopes, and last-used timestamps.
api_keys_create
Create a new API key. Full key is returned only once. Store it immediately.
api_keys_rotate
Rotate an API key: deactivate old, issue new with same scopes.
api_keys_revoke
Permanently revoke an API key. Irreversible.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"herohunt.ai mcp (people search api)": {
"herohunt-people-search": {
"command": "npx",
"args": [
"-y",
"herohunt-mcp"
],
"env": {
"HEROHUNT_API_KEY": "YOUR_API_KEY"
}
}
}
}
}McpServers
{
"herohunt-people-search": {
"command": "npx",
"args": [
"-y",
"herohunt-mcp"
],
"env": {
"HEROHUNT_API_KEY": "YOUR_API_KEY"
}
}
}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
- API Documentation
- Sign Up
- Dashboard
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
