# herohunt-mcp [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/herohunt-ai/herohunt-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 136  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/herohunt-mcp

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

## Tools
Capabilities this server exposes over MCP:

- **people_search** — Search for people profiles using natural language. 1 credit per reserved slot.
- **people_search_paginate** — Fetch more results for an existing search. Free unless enrichment is on.
- **account_usage_get** — Get plan, credits, rate limit info. Free.
- **account_searches_list** — List past searches. Free.
- **account_upgrade_link** — Get plan upgrade URL. Free.
- **account_billing_portal_link** — Get Stripe billing portal URL. Free.
- **api_keys_list** — List API key prefixes and scopes. Free.
- **api_keys_create** — Create a new API key.
- **api_keys_rotate** — Rotate an existing API key.
- **api_keys_revoke** — Permanently revoke an API key.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "herohunt-mcp": {
    "command": "npx",
    "args": ["-y","herohunt-mcp"],
    "env": {
      "HEROHUNT_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `HEROHUNT_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What herohunt-mcp does

The herohunt-mcp MCP server exposes the HeroHunt People Search API to MCP-compatible AI agents. It lets an agent search for people using natural-language criteria across LinkedIn, GitHub, and StackOverflow. Search results can include structured profile details such as a person’s name, title, company, location, skills, and platform links.

The service is intended for candidate and talent discovery. An agent can submit a query such as finding senior Go engineers in Berlin, review the returned profiles, and summarize selected results. The API describes a search as reserving result slots, with one credit charged per reserved slot.

## How it works

The server supports two connection patterns. With remote MCP transport, a client connects directly to HeroHunt’s hosted endpoint and sends an API key in the Authorization header. With stdio transport, the client starts the package through npx and passes the API key as an environment variable.

The primary workflow begins with `people_search`, which accepts a natural-language people-search request. `people_search_paginate` retrieves additional results for an existing search. Pagination is free unless enrichment is enabled. Enrichment can be requested when the agent needs contact details such as email addresses or phone numbers, as described by the project’s example.

Account and administration operations use separate tools. These provide usage and rate-limit information, list previous searches, return upgrade and Stripe billing portal links, and manage API keys.

## Setup and configuration

The herohunt-mcp MCP server requires a HeroHunt People Search API key, obtained by signing up through the HeroHunt API account page. For a remote configuration, add `https://api.herohunt.ai/api/v1/mcp` as the MCP URL and send the key as a Bearer token.

For clients that only support stdio, configure the server with `npx -y herohunt-mcp` and set `HEROHUNT_API_KEY`. The default MCP endpoint is the same hosted URL; `HEROHUNT_MCP_URL` can override it when needed. The README provides configuration examples for Claude Desktop and Cursor.

## Tools and capabilities

- `people_search`: Search for profiles with natural-language criteria. Each reserved slot costs one credit.
- `people_search_paginate`: Fetch more results from an existing search, with enrichment available when requested.
- `account_usage_get`: View plan, credit, and rate-limit information.
- `account_searches_list`: Review prior searches.
- `account_upgrade_link`: Retrieve a plan-upgrade URL.
- `account_billing_portal_link`: Retrieve a Stripe billing portal URL.
- `api_keys_list`: List API key prefixes and scopes.
- `api_keys_create`: Create an API key.
- `api_keys_rotate`: Rotate an existing key.
- `api_keys_revoke`: Permanently revoke a key.

## Limitations and notes

The server depends on a valid HeroHunt API key and the availability of the HeroHunt People Search API. Search usage is credit-based, and the project states that one credit is charged per reserved result slot. Additional pagination is free only when enrichment is not enabled.

API key creation, rotation, and revocation are account-affecting operations, so agents should use them only when explicitly authorized.

_Full upstream README: https://allmcps.com/mcp/herohunt-mcp/readme_