hh.ru MCP
hh-mcp
MCP server for the hh.ru API: vacancy and employer search, salary estimates, reference lists, resumes with employer access
Install
claude mcp add hh -- npx -y @theyahia/hh-mcpWith a token: claude mcp add hh -e HH_ACCESS_TOKEN=your-token -- npx -y @theyahia/hh-mcp
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 roleLimitations
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.
MCP
- Transport
- stdio, http
- Authentication
- not required
| Environment variables | |
|---|---|
| HH_ACCESS_TOKEN secret | Employer OAuth token for resume access |
| HH_USER_AGENT | Custom HH-User-Agent header |
| HTTP_PORT | HTTP mode port, default 3000 |
Security check
- Calls the hh.ru API
- With an employer token it retrieves resumes containing candidates' personal data
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.
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.
Related
166 skills for scientific work: bioinformatics, cheminformatics, clinical data, geospatial analysis and 100+ databases
Google's open-source MCP server for databases: ready tools for Postgres, MySQL, BigQuery, Spanner and more, plus custom tools in tools.yaml
Official Hugging Face skills: Hub operations via the hf CLI, datasets, model training, Spaces, evals and deployment
A token-lean MCP server for PostgreSQL, MySQL, MariaDB, SQL Server and SQLite with a read-only mode