hh-mcp: 52 tools for hh.ru

Install

npx skillfoxx add mcp/andreytepaykin-hh-mcp

claude mcp add --transport stdio hh -- npx -y @andrey-tepaykin/hh-mcp

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

code --add-mcp '{"name":"hh","type":"stdio","command":"npx","args":["-y","@andrey-tepaykin/hh-mcp"]}'

{
  "servers": {
    "hh": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

codex mcp add hh -- npx -y @andrey-tepaykin/hh-mcp

[mcp_servers.hh]
command = "npx"
args = ["-y", "@andrey-tepaykin/hh-mcp"]

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcp": {
    "hh": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "context_servers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": [
        "-y",
        "@andrey-tepaykin/hh-mcp"
      ]
    }
  }
}

claude mcp add hh -- npx -y @andrey-tepaykin/hh-mcp

This is third-party code. Review the repository files before installing.

What it does

The server wraps the official hh.ru API (dev.hh.ru) in 52 tools. Without a token you get vacancy search by keyword, region, role, salary and experience, a vacancy card, similar and related vacancies, employer profiles and vacancies, salary statistics from listings, and every reference dictionary: regions, industries, metro stations, languages, skills. With an employer token (HH_ACCESS_TOKEN) you additionally get resume search, application cards, an ATS pipeline by stage, candidate messaging history and manager statistics. However, resume search and ATS further require a paid resume-database subscription, otherwise hh.ru returns 403. Responses default to compact LLM-friendly summaries; raw: true returns the full hh.ru JSON. A built-in limiter respects hh.ru's 5 requests-per-second cap and retries on 429 and 5xx with exponential backoff. There's a separate stateless HTTP mode with DNS-rebinding protection, plus a bundled Claude Code /job-search skill with a ready-made search-and-triage workflow.

Who it is for. For job seekers who search vacancies and compare salaries through an agent, and for recruiters with paid hh.ru access who want their application pipeline in chat.

Example request

Find remote Python developer jobs in Moscow from 300,000 rubles and show the median salary

Limitations

Based on @theyahia/hh-mcp, this is a reworked fork rather than an original idea. Resume search and ATS need not just an employer token but a paid resume-database subscription. Job-seeker and anonymous tokens get 403. The built-in limiter is shared per process, so in HTTP mode with multiple clients they share one 5-requests-per-second budget. HTTP mode listens on localhost only by default; exposing it externally requires configuring HH_ALLOWED_HOSTS, HH_ALLOWED_ORIGINS and authentication yourself.

How to disable. Run claude mcp remove hh in Claude Code, or remove the hh block from mcpServers in your client configuration.

MCP

Transport

stdio, http

Authentication

API key

Security check

• With an employer token it returns candidate resumes and application correspondence
• There are no tools to submit applications or send messages, only reading, but the token should still be kept secret

README in short

The README lists all 52 tools by section (vacancies, resumes, ATS/applications, employers, reference data, salaries), a table of tokenless vs. token modes, install instructions for Claude Desktop, Claude Code, VS Code/Cursor, Windsurf and a separate HTTP mode, environment variables and demo prompts. It states the project is based on @theyahia/hh-mcp. MIT license.

Related