
Hh Mcp
Connects Claude to hh.ru, the major job platform for Russia and CIS markets. Exposes 16 tools covering vacancy search with filters for salary, region, and experience, plus employer lookups, salary statistics by professional role, and autocomplete for positions and companies. Works without auth for most operations. Add an OAuth token to unlock resume search and detailed candidate profiles. Handles rate limiting automatically at 5 requests per second with retry logic. Useful if you're building job search agents, compensation research tools, or recruitment workflows targeting Russian-speaking markets. Part of a broader Russian API MCP series.
- tools
- 19
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Mar 31, 2026
Tools
19 toolsPublic tool metadata for what this MCP can expose to an agent.
search_vacanciesПоиск по ключевым словам, региону, профессиональной роли, отрасли, метро, работодателю, зарплате, опыту, формату работы и типу занятости, периоду, меткам и полю поиска, с сортировкой и пагинацией
Поиск по ключевым словам, региону, профессиональной роли, отрасли, метро, работодателю, зарплате, опыту, формату работы и типу занятости, периоду, меткам и полю поиска, с сортировкой и пагинацией
No parameter schema in public metadata yet.
get_vacancyПолная карточка вакансии: описание, требования, ключевые навыки, контакты
Полная карточка вакансии: описание, требования, ключевые навыки, контакты
No parameter schema in public metadata yet.
get_similar_vacanciesНайти вакансии, похожие на заданную
Найти вакансии, похожие на заданную
No parameter schema in public metadata yet.
search_resumesПоиск резюме кандидатов по ключевым словам, региону, роли, зарплате, опыту
Поиск резюме кандидатов по ключевым словам, региону, роли, зарплате, опыту
No parameter schema in public metadata yet.
get_resumeПолное резюме: опыт, образование, навыки, контакты
Полное резюме: опыт, образование, навыки, контакты
No parameter schema in public metadata yet.
search_employersПоиск компаний по названию и региону
Поиск компаний по названию и региону
No parameter schema in public metadata yet.
get_employerПрофиль работодателя: описание, отрасли, сайт, число вакансий
Профиль работодателя: описание, отрасли, сайт, число вакансий
No parameter schema in public metadata yet.
get_employer_vacanciesАктивные вакансии конкретного работодателя
Активные вакансии конкретного работодателя
No parameter schema in public metadata yet.
get_areasДерево регионов и городов (id — название)
Дерево регионов и городов (id — название)
No parameter schema in public metadata yet.
get_areas_subtreeРегионы и города внутри одного региона — легче, чем всё дерево
Регионы и города внутри одного региона — легче, чем всё дерево
No parameter schema in public metadata yet.
get_professional_rolesДерево профессиональных ролей с ID
Дерево профессиональных ролей с ID
No parameter schema in public metadata yet.
get_industriesДерево отраслей компаний с ID
Дерево отраслей компаний с ID
No parameter schema in public metadata yet.
get_metroСтанции и линии метро с ID по городу
Станции и линии метро с ID по городу
No parameter schema in public metadata yet.
get_dictionariesВсе справочные данные: валюты, типы занятости, графики, опыт, метки
Все справочные данные: валюты, типы занятости, графики, опыт, метки
No parameter schema in public metadata yet.
suggest_positionsАвтодополнение названий должностей
Автодополнение названий должностей
No parameter schema in public metadata yet.
suggest_companiesАвтодополнение названий компаний
Автодополнение названий компаний
No parameter schema in public metadata yet.
suggest_areasАвтодополнение названий регионов и городов
Автодополнение названий регионов и городов
No parameter schema in public metadata yet.
get_salary_statisticsОценочное распределение зарплат (медиана, P25/P75, мин/макс) по роли в регионе, посчитанное по зарплатам опубликованных вакансий
Оценочное распределение зарплат (медиана, P25/P75, мин/макс) по роли в регионе, посчитанное по зарплатам опубликованных вакансий
No parameter schema in public metadata yet.
validate_tokenПроверить, действителен ли HH_ACCESS_TOKEN (через /me), и показать роль аккаунта
Проверить, действителен ли HH_ACCESS_TOKEN (через /me), и показать роль аккаунта
No parameter schema in public metadata yet.
Sponsors
Configuration
API_KEY*secretAPI key for the service
Readme
MCP-сервер для hh.ru API — 19 инструментов для ИИ-агента: вакансии, резюме, зарплаты
Если вы искали, как подключить hh.ru к Claude или другому ИИ-агенту, — этот сервер даёт агенту поиск по вакансиям и резюме, карточки работодателей, статистику зарплат и справочники hh.ru по России и СНГ. Спрашиваете «найди Python-вакансии в Москве от 250 000 ₽ на удалёнке» — агент возвращает готовый список с зарплатами и опытом, а не ссылку на выдачу. Поиск вакансий работает без токена; токен нужен только для базы резюме.
Details
- Repository
- github.com/theyahia/hh-mcp
- Category
- Search & Web Crawling
- Package
@theyahia/hh-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from theyahia
- Huntflow Mcp
- Kontur Focus Mcp
- Robokassa Mcp
- Roistat Mcp
- Sendpulse Mcp
- Sms Ru Mcp
- Superjob Mcp
- Tkassa Mcp
- Travelpayouts Mcp
- Unisender Mcp
- Vk Mcp
- Getcourse Mcp
- Jivosite Mcp
- Kaspi Mcp
- Retailcrm Mcp
- Sber Mcp
- Yandex Speechkit Mcp
- yandex-direct-mcp4
- claude-webcache1
- yandex-metrika-mcp1
- Yookassa Mcp3
- voximplant-mcp1
- mts-exolve-mcp
- Chestnyznak Mcp1