SkillFoxx

Hackathon MCP server for hh.ru vacancy search

SecondHackaton-HackAI

A small MCP server and agent from a Cloud.ru hackathon: hh.ru vacancy search and details through the open API, no access token needed

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Runs a Python server that searches vacancies through the public hh.ru API
  • An LLM key is needed only for the test agent in the repo
All reasons and checks
Russian stack

obure22/secondhackaton-hackaiAuthor:Obure22

Install

Services

Manual install

pip install -r requirements.txt

Installing dependencies from the README.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Runs a Python server that searches vacancies through the public hh.ru API
  • An LLM key is needed only for the test agent in the repo

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

What it does

The project was built at the Cloud.ru AI Devtools Hack and consists of an MCP server (main.py) plus a separate test AI agent (app/main_agent_test.py) on top of it. The app/tools folder structure shows search_vacancies, search_vacancies_advanced, get_vacancy_details and list_uploads tools. The README calls the hh.ru API "open to use," meaning the server hits public vacancy search with no token of its own, while running the LLM agent only needs an LLM_API_KEY in .env. Documentation is limited to a README with run commands; there's no detailed description of tool parameters in the repository.

Who it is for. For people who want a minimal working hh.ru vacancy-search MCP server as a base for their own project, not a finished polished solution.

Good fit when

  • You want a simple example hh.ru vacancy-search MCP server with no token, as a starting point
  • You want a ready Docker Compose setup and both stdio and SSE transports as a base
  • You're fine with minimal documentation and the project's hackathon origin

Not a fit when

  • You need detailed documentation of tools and parameters: the repository only has a README with run commands
  • You need an actively maintained project: the last push is from December 2025, right after the hackathon
  • You need advanced features like applying, resumes or analytics: the toolset is limited to search and vacancy details

Example request

Find backend developer vacancies on hh.ru and show details for the first three

MCP

Transport
stdio, sse
Authentication
not required

Environment variables

LLM_API_KEY secret
An LLM provider key for the test agent, not needed by the MCP server itself.

Limitations

Documentation is limited to a short README; tool parameters need to be checked directly in the app/tools code. The project hasn't been updated since December 2025, right after the Cloud.ru hackathon. A .env file is committed to the repository (without a real key), which is worth checking before using someone else's fork.

How to disable. Stop the main.py process and remove the server from your MCP client configuration.

FAQ

Do I need an hh.ru token?

No, the README calls the hh.ru API open to use, and the server searches vacancies with no token of its own.

What is LLM_API_KEY for?

It's only needed for the test agent in app/main_agent_test.py, not for the MCP server itself.

Discussion

No questions or reviews yet.

All hh.ru tools
Russian stack

A browser-based MCP server for job search on hh.ru: resume-matched vacancy recommendations, applications and statuses

MCP serverBroad access3
Russian stack

An MCP server with 52 tools over the official hh.ru API: vacancy search with no token, employer resumes and applications with one, and salary statistics

MCP serverExtended access

hh.ru MCP

hh-mcp

Russian stack

MCP server for the hh.ru API: vacancy and employer search, salary estimates, reference lists, resumes with employer access

MCP serverExtended access10
Russian stack

An hh.ru API MCP server for job seekers: vacancy search, employer data, your resumes and applications with cover letters

MCP serverBroad access39
Russian stack

An MCP server for the employer side of the hh.ru and hh.kz API: your vacancies, applications, resume search, sourcing and webhooks through an OAuth app

MCP serverBroad access1
Russian stack

An MCP server that aggregates vacancies from hh.ru and the public Greenhouse, Ashby, Lever, Workable and Bayt APIs into one format without HTML scraping

MCP serverExtended access1

README in short

The short Russian README describes the project as an agent for automatic hh.ru vacancy search from the Cloud.ru AI Devtools Hack, names the team, and gives commands for installing dependencies, setting LLM_API_KEY, and running the test agent and MCP server separately. It links to a video install walkthrough. MIT license.

README badge

Report a problem