Hh MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/theyahia-hh-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

19 read · 0 write · 0 deleteRead-only

Secrets

1 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (19)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• get_areas

  Get the full tree of regions and cities as `id — name` lines (pass raw:true for nested JSON). Use to find area IDs for search filters.

• get_areas_subtree

  Get the regions/cities subtree under one area id (e.g. 113=Russia) — lighter than the full /areas tree.

• get_dictionaries

  Get all reference dictionaries: currencies, employment types, schedules, experience levels, vacancy labels, and more.

• get_employer

  Get detailed employer profile: description, industries, website, vacancy count.

• get_employer_vacancies

  List active vacancies for a specific employer.

• get_industries

  Get the tree of company industries with IDs. Use to find industry IDs for the search_vacancies `industry` filter.

• get_metro

  Get metro stations and lines with IDs for a city (city_id), or for all cities. Use to find metro IDs for the search_vacancies `metro` filter.

• get_professional_roles

  Get the tree of professional roles with IDs. Use to find role IDs for vacancy/resume search and salary stats.

• get_resume

  Get full resume details: experience, education, skills, contacts. Requires an EMPLOYER OAuth token + paid resume-database access.

• get_salary_statistics

  Estimate salary distribution (median, P25/P75, min/max) for a professional role in a region by sampling posted vacancy salaries client-side. Biased sample (only vacancies that disclose salary) — not official market data.

• get_similar_vacancies

  Find vacancies similar to a given one. Useful for expanding a candidate's job search.

• get_vacancy

  Get full vacancy details: description, requirements, key skills, contacts, employer info.

• search_employers

  Search companies/employers on hh.ru by name. Returns company info and open vacancy count.

• search_resumes

  Search candidate resumes by keywords, region, professional role, salary, experience. Requires an EMPLOYER OAuth token (HH_ACCESS_TOKEN) AND a paid hh.ru resume-database subscription — applicant/anonymous tokens get 403.

• search_vacancies

  Search job vacancies on hh.ru by keywords, region, professional role, industry, metro, salary, experience, employment form, work format, date range and labels. Returns a compact paginated summary (pass raw:true for full JSON).

Signals

Stars

5

Forks

1

Open issues

1

Last commit

Sep 6, 2026 (1 month ago)

Last release

Sep 2, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.theYahia/hh-mcp

Version

1.0.0

Auth

API key

Packages

npm @theyahia/hh-mcp

License

MIT

Repository

github.com/theYahia/hh-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql