hh.ru MCP: Documentation
Updated:
Connection
npx -y @theyahia/hh-mcp (stdio) or npx @theyahia/hh-mcp --http (port from HTTP_PORT/PORT, binds to 127.0.0.1). With no token: vacancies and stats. With HH_ACCESS_TOKEN (get one at dev.hh.ru/admin): resumes too — but resume search additionally needs an employer account with a paid resume-database subscription (otherwise 403).
Capabilities
19 tools: vacancies (search_vacancies, get_vacancy, get_similar_vacancies), resumes (search_resumes, get_resume — token only), employers (search_employers, get_employer, get_employer_vacancies), dictionaries and autocomplete (get_areas/get_areas_subtree, get_professional_roles, get_industries, get_metro, get_dictionaries, suggest_positions/suggest_companies/suggest_areas), salary and account (get_salary_statistics, validate_token). Any search/detail tool accepts raw: true for the full hh.ru JSON.
Agent flow
"What's the salary range for Go developers in St. Petersburg?", "collect Yandex's vacancies and compare requirements", "compare Senior Backend salaries in Moscow vs St. Petersburg".
Note
A community project (theYahia), not an official HeadHunter product. get_salary_statistics is an estimate from posted vacancies, not official market data.