How do I use herohunt-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@herohunt-mcp Find me 5 senior Go engineers in Berlin and summarize the top 3." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

herohunt-mcp

Official

by herohunt-ai

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

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"
      }
    }
  }
}

Related MCP server: orca-ai-mcp

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

License

MIT

Available Tools

10 tools

account_billing_portal_linkA

Get Stripe Customer Portal URL for managing subscriptions. Free.

Name	Required	Description	Default
No parameters

account_searches_listC

List past searches with first-page profiles. Free.

Name	Required	Description
`page`	No	History page.
`limit`	No	Number of past searches (default 20).
`includeLogs`	No	Include pipeline logs.
`per_search_page`	No	Profiles per past search (default 10).
`returnAllProfiles`	No	Include all profiles per search.

account_upgrade_linkB

Get a dashboard URL prefilled with account email for plan upgrades. Free.

Name	Required	Description	Default
No parameters

account_usage_getB

Get plan, total/used/remaining credits, rate limit, and next credit reset date. Free.

Name	Required	Description	Default
No parameters

api_keys_createA

Create a new API key. Full key is returned only once. Store it immediately.

Name	Required	Description
`name`	Yes	Friendly name for the key (e.g. "CI Bot").
`scopes`	No	Permission scopes. Defaults to people:search.
`expiresAt`	No	ISO-8601 expiry date (optional).

api_keys_listA

List API key prefixes, scopes, and last-used timestamps.

Name	Required	Description	Default
No parameters

api_keys_revokeB

Permanently revoke an API key. Irreversible.

Name	Required	Description	Default
`keyId`	Yes	ID of the key to revoke.

api_keys_rotateA

Rotate an API key: deactivate old, issue new with same scopes.

Name	Required	Description	Default
`keyId`	Yes	ID of the key to rotate.

people_searchA

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.

Name	Required	Description
`page`	No	Page number.
`query`	No	Natural language query. Required for new searches.
`enrich`	No	Request email/phone enrichment for LinkedIn profiles.
`filters`	No	Structured filters.
`per_page`	No	Results per page (max 50, default 10).
`searchId`	No	Existing search ID for pagination.
`timeoutMs`	No	Max wait time in ms.
`maxResults`	No	Max profiles to collect (default 100). Charged up front.
`includeLogs`	No	Include pipeline trace logs.
`returnAllProfiles`	No	Return all matched profiles, not just current page.

people_search_paginateC

Fetch additional pages for an existing search. Free unless enrich is enabled.

Name	Required	Description
`page`	No	Page number.
`enrich`	No	Request enrichment (+1 credit per enriched profile).
`per_page`	No	Results per page.
`searchId`	Yes	ID of existing search to paginate.
`includeLogs`	No	Include pipeline logs.
`returnAllProfiles`	No	Return all matched profiles.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

10 tool updatesv1.0.2Jul 28, 2026
- First observedaccount_billing_portal_link
- First observedaccount_searches_list
- First observedaccount_upgrade_link
- First observedaccount_usage_get
- First observedapi_keys_create
- First observedapi_keys_list
- First observedapi_keys_revoke
- First observedapi_keys_rotate
- First observedpeople_search
- First observedpeople_search_paginate

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.7/5.0

Scored 2026-07-28 19:35 across 10 tools

Disambiguation5/5

Tools are cleanly separated across three domains: people search, account management, and API keys. The two search tools are distinct (initial search vs. pagination), and account and API key tools have clearly different purposes. No overlapping or ambiguous functions.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern in snake_case, e.g., people_search, account_usage_get, api_keys_create. The naming style is uniform and predictable, with minor but acceptable variation in verbs (get, list, create, etc.).

Tool Count5/5

10 tools is well-scoped for a server combining people search, account management, and API key management. Each tool serves a distinct and necessary function, with no redundancy or excessive granularity.

Completeness4/5

The set covers core workflows: search with pagination, account usage and history, billing and upgrade links, and full CRUD for API keys. Minor gaps include no direct profile detail retrieval (beyond search results) and no API key scope update (rotate reuses same scopes).

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Norvstar — Professional Identity MCP Server
com.norvstar
Query professional profiles, search candidates, and get AI-powered summaries and job fit analysis.
Search Research & Data Marketing
2
https://norvstar.com/api/mcp
cv.json — open CV dataA
io.github.freecvorg
Search people open to work and fetch their machine-readable cv.json, from any AI assistant.
Search Open Data
414
https://freecv.org/api/mcp
Fiber AIA
ai.fiber
Search companies, enrich contacts, and reveal emails and phones from your AI agent.
Search Customer Data Platforms Marketing
52
https://mcp.fiber.ai/mcp
TopClozer LinkedIn MCP
com.topclozer
LinkedIn for AI agents: search people, read profiles, posts and connections via a connected account
Social Media Search
1
https://topclozer.com/api/mcp

Related MCP Servers

recruiting-jobs-mcp
Web Scraping Search Research & Data
emily397
F
license
Not graded
quality
C
maintenance
Enables AI agents to pull live job listings from major ATS platforms (Greenhouse, Lever, Ashby, Workable), Hacker News hiring threads, and detect hiring signals on company career pages.
Updated 5 months ago (2026-06-18 05:15 UTC)
-
orca-ai-mcp
Research & Data Search
justinmccuistion
A
license
Not graded
quality
D
maintenance
Integrates with Orca AI's HUNT Platform API to search for information about people, companies, and entities, enabling AI assistants to access investigative intelligence and due diligence data.
Updated 9 months ago (2026-02-14 11:56 UTC)
MIT
GitHunt MCP
Search Research & Data
githunt-agent
A
license
A
quality
C
maintenance
GitHunt MCP gives AI assistants access to developer talent-discovery engine. Search a pool of millions of GitHub developers by location, role, and skills; pull a single developer's ranked profile, or run deep analysis on a candidate. Results come back ranked by fit with transparent scoring, experience, commit activity, OSS contributions and the contact info, so an agent can build a shortlist.
Updated 4 months ago (2026-07-24 20:31 UTC)
3
65 npm
MIT
mcp-greenhouse
CRM Search
pipeworx-io
A
license
Not graded
quality
C
maintenance
Enables AI agents to search candidates, view job postings, and manage applications in Greenhouse ATS via natural language queries.
Updated 8 days ago (2026-11-02 02:07 UTC)
472 npm
MIT

herohunt-mcp

Quick Start

Option 1: Remote URL (recommended)

Option 2: stdio (via npx)

Get Your API Key

Tools

Example

Environment Variables

Links

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

recruiting-jobs-mcp

orca-ai-mcp

GitHunt MCP

mcp-greenhouse