mcpField
H
HeroHunt.ai MCP (People Search API)

HeroHunt.ai MCP (People Search API)

Local
github.com/herohunt-aiDeveloper Tools0Updated 25w ago
Repository

About HeroHunt.ai MCP (People Search API)

HeroHunt.ai MCP connects MCP-compatible agents to the HeroHunt People Search API for sourcing talent across LinkedIn, GitHub, and StackOverflow. It supports natural-language searches, profile pagination, and contact enrichment alongside account and API-key management.

Key features

  1. 01Natural-language people search
  2. 02Search LinkedIn, GitHub, and StackOverflow
  3. 03Paginate search results
  4. 04Enrich profiles with contact details
  5. 05Manage account and API keys

Use cases

  1. 01Find candidates by role and location
  2. 02Review additional results from a search
  3. 03Retrieve email addresses and phone numbers

MCP support

Exposes people-search, pagination, enrichment, account, and API-key tools to MCP clients. Connect using a remote HTTP endpoint or the stdio package.

#people#search#recruitment#recruit#linkedin#talent#sourcing#enrichment

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "herohunt": {
      "command": "npx",
      "args": [
        "-y",
        "herohunt-mcp"
      ],
      "env": {
        "HEROHUNT_API_KEY": "<HEROHUNT_API_KEY>"
      }
    }
  }
}
Run commandnpx -y herohunt-mcp
Environment variables to set
HEROHUNT_API_KEYSecretHeroHunt API key. Get one at https://www.herohunt.ai/app/api/sign-up

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmherohunt-mcp1.0.2

Tools

10

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
querystringNoNatural language query. Required for new searches.
searchIdstringNoExisting search ID for pagination.
filtersobjectNoStructured filters.
filters.locationsarrayNoCandidate locations.
filters.platformsarrayNoPlatforms to search. Defaults to all.
filters.skillsarrayNoRequired skills.
filters.languagesarrayNoProgramming languages.
filters.currentCompanystringNoCurrent company filter.
maxResultsintegerNoMax profiles to collect (default 100). Charged up front.
enrichbooleanNoRequest email/phone enrichment for LinkedIn profiles.
pageintegerNoPage number.
per_pageintegerNoResults per page (max 50, default 10).
timeoutMsintegerNoMax wait time in ms.
includeLogsbooleanNoInclude pipeline trace logs.
returnAllProfilesbooleanNoReturn all matched profiles, not just current page.

Details

From the project README

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

ToolTypeDescription
people_searchWriteSearch for people profiles using natural language. 1 credit per reserved slot.
people_search_paginateReadFetch more results for an existing search. Free unless enrichment is on.
account_usage_getReadGet plan, credits, rate limit info. Free.
account_searches_listReadList past searches. Free.
account_upgrade_linkReadGet plan upgrade URL. Free.
account_billing_portal_linkReadGet Stripe billing portal URL. Free.
api_keys_listReadList API key prefixes and scopes. Free.
api_keys_createWriteCreate a new API key.
api_keys_rotateWriteRotate an existing API key.
api_keys_revokeWritePermanently 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

VariableRequiredDefaultDescription
HEROHUNT_API_KEYYes-Your People Search API key
HEROHUNT_MCP_URLNohttps://api.herohunt.ai/api/v1/mcpOverride the MCP endpoint URL

Links

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.