Herohunt Mcp

io.github.herohunt-aiPublished by GitHub account herohunt-aiv1.0.2Updated Oct 24, 2026

People search API - find 1 billion candidates across LinkedIn and GitHub with real-time data.

VerifiedSTDIODesktop onlyWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

MCP server for the HeroHunt People Search API, letting an assistant find candidate profiles across LinkedIn, GitHub and StackOverflow and manage the account's H

What you can do
Search for people profiles with natural-language queries and page through further results, optionally enriching them with contact details. Review account plan, credits and rate limits, and list past searches. Get upgrade and billing portal links. List, create, rotate and revoke API keys.
When to use it
Useful for recruiting or sourcing work where an assistant should run talent searches and summarize candidate profiles without leaving the chat. Also handy for checking search credits and managing API keys from the same session.
Requirements
A HeroHunt API key, supplied as the HEROHUNT_API_KEY environment variable for the local npm package or as a Bearer Authorization header for the remote endpoint. Network access to the HeroHunt API; an optional HEROHUNT_MCP_URL variable overrides the endpoint.
Before you install
The API key is a secret that grants access to the account and its credits. Searches consume credits (one per reserved slot), and enrichment may add cost. The server can create, rotate and revoke API keys, which changes account access. Candidate profile and contact data is sent to and returned from HeroHunt's servers.

Installation

In SourceWeft

  1. Open Herohunt Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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):

json
{  "mcpServers": {    "herohunt-people-search": {      "url": "https://api.herohunt.ai/api/v1/mcp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}

Cursor (~/.cursor/mcp.json):

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:

json
{  "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

Source: README.md at commit 6463135

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.