hh.ru MCP
hh-mcp
MCP server for the hh.ru API: vacancy and employer search, salary estimates, reference lists, resumes with employer access
- 5 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Calls the hh.ru API
- With an employer token it retrieves resumes containing candidates' personal data
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/hh-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Calls the hh.ru API
- With an employer token it retrieves resumes containing candidates' personal data
This is third-party code. Review the repository files before installing.
What it does
The server gives the agent 19 hh.ru API tools. Without a token it offers vacancy search filtered by region, role, salary, experience and work format, vacancy cards and similar vacancies, employer data, region, role, industry and metro reference lists, and autocomplete. The salary tool computes a median and percentiles from published vacancies, an estimate rather than market data. Resume search and viewing need an employer token with paid database access. Responses are compact by default, with full JSON via the raw flag.
Who it is for. Recruiters, HR analysts and job seekers working with hh.ru vacancies.
Good fit when
- You need vacancies matching a stack, city and salary
- You want a rough salary range for a role in a region
- You want all open vacancies of a specific company
Not a fit when
- You need to apply or manage your own vacancies: there are no such tools
- You need official labor market data rather than an estimate from listings
Example request
Find remote Python developer vacancies in Moscow from 300,000 rubles and estimate the median salary for the roleMCP
- Transport
- stdio, http
- Authentication
- not required
Environment variables
HH_ACCESS_TOKENsecret- Employer OAuth token for resume access
HH_USER_AGENT- Custom HH-User-Agent header
HTTP_PORT- HTTP mode port, default 3000
Limitations
Resumes require an employer OAuth token and a paid resume database subscription, otherwise the API returns 403. The built-in 5 requests per second limit is per process, so all clients share it in HTTP mode. HTTP mode has no auth of its own and listens on localhost by default.
How to disable. Remove it with claude mcp remove hh or delete the hh block from your client config.
FAQ
Do I need an hh.ru account?
Not for vacancies, employers, salaries and reference lists. A token from dev.hh.ru is only needed for resumes.
How accurate are salary stats?
They are computed from vacancies with a stated salary, so the sample is biased. Treat them as a rough guide.
How is hh.ru MCP different from searching vacancies on the site?
The server gives the agent 19 hh.ru API tools. Without a token you get vacancy search with filters by region, role, salary, experience and work format, vacancy cards and similar vacancies, employer data and reference lists. Resumes need employer access.
Do I need to register on hh.ru and how accurate are salary stats?
Public search needs no token. Install with claude mcp add hh -- npx -y @theyahia/hh-mcp. Salary estimates come from vacancy data and give a guide, not an exact value. It works in Claude Desktop, Claude Code, VS Code, Cursor and Windsurf.
Discussion
No questions or reviews yet.
Related
All hh.ru toolsAn MCP server with 52 tools over the official hh.ru API: vacancy search with no token, employer resumes and applications with one, and salary statistics
An MCP server for the employer side of the hh.ru and hh.kz API: your vacancies, applications, resume search, sourcing and webhooks through an OAuth app
An hh.ru API MCP server for job seekers: vacancy search, employer data, your resumes and applications with cover letters
A browser-based MCP server for job search on hh.ru: resume-matched vacancy recommendations, applications and statuses
A cookie-session MCP server that gives an agent hh.ru search, applications, chats and resume analytics hidden from job seekers, no official API
ats-mcp-server: jobs from hh.ru and ATS platforms
ats-mcp-server
An MCP server that aggregates vacancies from hh.ru and the public Greenhouse, Ashby, Lever, Workable and Bayt APIs into one format without HTML scraping
README in short
The Russian README separates token-free and token modes and is upfront about resume access requirements. It gives configs for Claude Desktop, Claude Code, VS Code, Cursor and Windsurf, plus a Streamable HTTP mode with DNS rebinding protection. All tools are listed in tables marked by token requirement. The repo also includes a job-search skill that pairs vacancy search with salary estimates. MIT license.