{
  "markdown": "# herohunt-mcp\n\nMCP server for the [HeroHunt People Search API](https://www.herohunt.ai/people-search-api). Search for talent across LinkedIn, GitHub, and StackOverflow from any MCP-compatible AI agent.\n\n## Quick Start\n\n### Option 1: Remote URL (recommended)\n\nClaude Desktop, Cursor, and most modern MCP clients support remote HTTP endpoints directly. No package installation needed.\n\n**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"herohunt-people-search\": {\n      \"url\": \"https://api.herohunt.ai/api/v1/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n**Cursor** (`~/.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"herohunt-people-search\": {\n      \"url\": \"https://api.herohunt.ai/api/v1/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n### Option 2: stdio (via npx)\n\nFor MCP clients that only support stdio transport:\n\n```json\n{\n  \"mcpServers\": {\n    \"herohunt-people-search\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"herohunt-mcp\"],\n      \"env\": {\n        \"HEROHUNT_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n## Get Your API Key\n\nSign up at [herohunt.ai/app/api/sign-up](https://www.herohunt.ai/app/api/sign-up) to get your API key.\n\n## Tools\n\n| Tool | Type | Description |\n|------|------|-------------|\n| `people_search` | Write | Search for people profiles using natural language. 1 credit per reserved slot. |\n| `people_search_paginate` | Read | Fetch more results for an existing search. Free unless enrichment is on. |\n| `account_usage_get` | Read | Get plan, credits, rate limit info. Free. |\n| `account_searches_list` | Read | List past searches. Free. |\n| `account_upgrade_link` | Read | Get plan upgrade URL. Free. |\n| `account_billing_portal_link` | Read | Get Stripe billing portal URL. Free. |\n| `api_keys_list` | Read | List API key prefixes and scopes. Free. |\n| `api_keys_create` | Write | Create a new API key. |\n| `api_keys_rotate` | Write | Rotate an existing API key. |\n| `api_keys_revoke` | Write | Permanently revoke an API key. |\n\n## Example\n\nAfter connecting, ask your AI agent:\n\n> \"Use HeroHunt to find me 5 senior Go engineers in Berlin and summarise the top 3.\"\n\nThe 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.\n\nTo get contact info, ask:\n\n> \"Enrich the results with emails and phone numbers.\"\n\nThe agent will call `people_search_paginate` with `enrich: true`.\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `HEROHUNT_API_KEY` | Yes | - | Your People Search API key |\n| `HEROHUNT_MCP_URL` | No | `https://api.herohunt.ai/api/v1/mcp` | Override the MCP endpoint URL |\n\n## Links\n\n- [API Documentation](https://www.herohunt.ai/people-search-api)\n- [Sign Up](https://www.herohunt.ai/app/api/sign-up)\n- [Dashboard](https://www.herohunt.ai/app/api/dashboard)\n\n## License\n\nMIT\n",
  "bytes": 3102,
  "sha": "b68fdbde9d03feebe944f257cf72df963ddb54dfd451175a2e7c797851cfc864",
  "repo_slug": "herohunt-ai/herohunt-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_herohunt_ai_herohunt_mcp_3f1897f1/readme"
}