githunt-mcp

An MCP server that gives your AI assistant a recruiter's view of GitHub. It wraps GitHunt's API so Claude, Cursor, and other MCP clients can search a pre-indexed pool of GitHub developers, look up a ranked profile, and run deep AI analysis on a candidate - all from a chat prompt.

Ask "find backend engineers in Berlin who know Go and Kubernetes" and get back a ranked, scored shortlist with activity signals and contact info.

Prefer zero setup? GitHunt also runs a hosted MCP server at https://mcp.githunt.ai/mcp. Add it as a custom connector in Claude (Settings -> Connectors) or as a remote MCP server in your client and sign in with your GitHunt account - no API key or local process needed. This package is the self-hosted (stdio) alternative.

Quickstart

1. Grab an API key from your GitHunt account.

2. Run the server:

   GITHUNT_API_KEY=your-key-here npx githunt-mcp
   

3. Wire it into your client (see below), then just ask.

Environment variables

Claude Code

claude mcp add githunt -e GITHUNT_API_KEY=your-key-here -- npx githunt-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "githunt": {
      "command": "npx",
      "args": ["githunt-mcp"],
      "env": {
        "GITHUNT_API_KEY": "your-key-here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "githunt": {
      "command": "npx",
      "args": ["githunt-mcp"],
      "env": {
        "GITHUNT_API_KEY": "your-key-here"
      }
    }
  }
}

Any MCP client that speaks stdio works the same way: run npx githunt-mcp with GITHUNT_API_KEY in the environment.

Try it

Once connected, prompt your assistant naturally:

• "Find senior frontend developers in Warsaw who know React and TypeScript."
• "Show me hireable DevOps engineers in Poland with 5+ years on GitHub."
• "Give me the next 25 candidates for that search." (paging via offset)
• "Pull up octocat's GitHunt profile."
• "Do a deep analysis of torvalds - proficiency, best-fit roles, any public emails."
• "Search for ML engineers in San Francisco, then analyze your top 3."

Tools

Supported role values: fullstack, frontend, backend, mobile, devops, ai-engineer, ai-orchestrator, ml-engineer, data-scientist, data-engineer, security, cloud, blockchain, embedded, gamedev, ios-developer, android-developer, sre, platform-engineer, `qa-eng

... View full README on GitHub