githunt-agent/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:
3. Wire it into your client (see below), then just ask.
Environment variables
| Variable | Required | Description |
|---|---|---|
| GITHUNT_API_KEY | yes | Your GitHunt API key |
| GITHUNT_API_URL | no | API base URL (default https://api.githunt.ai) |
Claude Code
Claude Desktop
Add to claude_desktop_config.json:
Cursor
Add to .cursor/mcp.json:
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
| Tool | What it does | Speed |
|---|---|---|
| search_developers | Search GitHunt's pre-indexed pool by location, role, skills, languages, and more. Returns candidates ranked by fit with scores, activity, and contact info. Pages via offset (0-200). Returns a markdown table plus structured JSON. If a location matches nothing, it suggests similar supported locations instead of an empty page. | Fast (pool-served, no live crawl) |
| get_developer | Get one developer's ranked profile by login/username: overall, profile, tech-stack, and activity scores, experience, commit activity, top repos, and contact info. | Fast (cache-first) |
| analyze_profile | Deep AI analysis of a profile from live GitHub data: proficiency level, best-fit roles, and extracted emails. Use it to vet a shortlisted candidate. | Slower (live crawl) |
**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-engineer, solutions-architect, cto, vp-engineering,
head-engineering, engineering-manager, tech-lead, product-manager,