Log inSubmit server
Herohunt MCP logo

Herohunt MCP

Searches LinkedIn, GitHub, and StackOverflow profiles through the HeroHunt People Search API.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Herohunt MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "herohunt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "herohunt-mcp"
      ],
      "env": {
        "HEROHUNT_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The herohunt-mcp MCP server connects AI agents to the HeroHunt People Search API for natural-language talent searches across LinkedIn, GitHub, and StackOverflow. It returns structured profile data and supports pagination, optional enrichment, account details, billing links, and API key management. Use it when an agent needs to find candidates by role, skills, location, or other profile criteria. The server is available through a remote MCP URL or as a local stdio process launched with npx.

Use cases

  • Find candidates by role, skills, and location
  • Search profiles across LinkedIn, GitHub, and StackOverflow
  • Paginate through candidate results
  • Enrich results with contact information
  • Check account usage and manage API keys

Key features

  • Natural-language people search
  • LinkedIn, GitHub, and StackOverflow coverage
  • Result pagination and optional enrichment
  • Usage, plan, and rate-limit queries
  • Account billing and upgrade links
  • API key lifecycle management

Tools10

What Herohunt MCP lets your agent do. Expand a tool for its parameters.

Self-reported~144 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

7/7 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · herohunt-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads136Package downloads in the last 30 days.
Last commit5mo agoMost recent push to the default branch.
Tools exposed10Callable tools this server registers over MCP.

How Herohunt MCP works

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Herohunt MCP

herohunt-mcp is an MCP server that connects AI agents to the HeroHunt People Search API across LinkedIn, GitHub, and StackOverflow. Its main tools search for people, paginate results, optionally enrich profiles, inspect account usage, and manage API keys.

Run it through npx for clients that use stdio by configuring the command `npx` with the argument `-y herohunt-mcp` and setting `HEROHUNT_API_KEY`. Clients supporting remote MCP can connect directly to HeroHunt’s hosted endpoint without package installation.

Yes, herohunt-mcp works with Cursor. Add the hosted MCP URL to Cursor’s MCP configuration and provide the API key as a Bearer token, as shown in the project README.

Request enrichment through `people_search_paginate` with `enrich: true`. The README gives email addresses and phone numbers as examples of contact information returned through enrichment, and notes that pagination is no longer free when enrichment is enabled.

Related MCP servers

All in Social Media All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHerohunt MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/herohunt-mcp?style=directory)](https://allmcps.com/mcp/herohunt-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/herohunt-mcp"><img src="https://allmcps.com/api/badge/herohunt-mcp?style=directory" alt="Herohunt MCP on AllMCPs" /></a>