Skip to main content
Glama
HuntFlow MCP Server

HuntFlow MCP Server

by theYahia

MCP-сервер для Huntflow — вакансии, кандидаты и резюме ATS через ИИ

Если вы искали, как подключить Huntflow к нейросети, найти кандидата и прочитать его резюме не листая карточки в ATS — это оно. 14 инструментов и 2 скилла: вакансии, кандидаты, резюме, этапы подбора, справочники, аккаунты. Спрашиваете «кто застрял на этапе техинтервью» — получаете список, а не выгрузку в CSV.

npm CI License: MIT

Часть серии WWmcp (46 серверов).

Установка

Claude Desktop (stdio)

{
  "mcpServers": {
    "huntflow": {
      "command": "npx",
      "args": ["-y", "@theyahia/huntflow-mcp"],
      "env": {
        "HUNTFLOW_TOKEN": "ваш-access-token",
        "HUNTFLOW_REFRESH_TOKEN": "ваш-refresh-token"
      }
    }
  }
}

Streamable HTTP

HUNTFLOW_TOKEN=ваш-токен npx @theyahia/huntflow-mcp --http
# POST /mcp, GET /health на 127.0.0.1:3000 (PORT=...)

Smithery

npx @smithery/cli install @theyahia/huntflow-mcp

Related MCP server: HeadHunter API MCP Server

Получение токена

Настройки HuntFlow → вкладка «API-токены» (API Tokens) → создать токен. Выданная пара включает access-токен (живёт ~7 дней) и refresh-токен (~14 дней). Сервер автоматически обновляет access-токен через POST /token/refresh при истечении и сохраняет ротированную пару в файл состояния (HUNTFLOW_TOKEN_FILE), переживая рестарты. Если задать только HUNTFLOW_TOKEN без refresh — сервер проработает до истечения access-токена (~7 дней), затем потребуется новый токен.

Переменные окружения

Переменная

Обяз.

Описание

HUNTFLOW_TOKEN

да

Access-токен (Настройки → API-токены)

HUNTFLOW_REFRESH_TOKEN

нет

Refresh-токен — включает авто-обновление при 401

HUNTFLOW_TOKEN_FILE

нет

Файл для хранения ротированной пары (по умолчанию ~/.huntflow-mcp/token.json)

HUNTFLOW_BASE_URL

нет

По умолчанию https://api.huntflow.ru/v2

HUNTFLOW_USER_AGENT

нет

User-Agent (обязателен для API; есть дефолт)

HUNTFLOW_TIMEOUT_MS

нет

Таймаут запроса, мс (по умолчанию 10000)

HUNTFLOW_DISABLE_RATELIMIT

нет

1 — отключить клиентский лимит 10 req/s

PORT

нет

Порт HTTP-сервера (по умолчанию 3000)

HUNTFLOW_HTTP_HOST

нет

Хост привязки HTTP (по умолчанию 127.0.0.1)

HUNTFLOW_HTTP_SECRET

нет

Если задан — требует Authorization: Bearer <secret> на /mcp

HUNTFLOW_ALLOWED_HOSTS

нет

Список host:port для защиты от DNS-rebinding

Инструменты (14)

Инструмент

Описание

list_accounts

Список доступных аккаунтов

list_vacancies

Список вакансий (фильтры opened/state/mine, пагинация)

get_vacancy

Полная информация о вакансии

search_applicants

Поиск кандидатов (q + фильтры vacancy/status/tag)

list_vacancy_applicants

Кандидаты, прикреплённые к конкретной вакансии

get_applicant

Полная информация о кандидате

get_applicant_resumes

Список резюме (external) кандидата

get_resume

Полное тело конкретного резюме (external)

list_stages

Этапы воронки подбора (статусы вакансий)

list_coworkers

Сотрудники/рекрутеры аккаунта

list_sources

Справочник источников кандидатов

list_rejection_reasons

Справочник причин отказа

list_divisions

Справочник подразделений

list_tags

Справочник тегов

Списочные инструменты возвращают курированный набор полей (экономия токенов) + structuredContent; передайте raw: true для полного сырого ответа. Пагинация — параметры page/count.

Скиллы (Prompts)

Скилл

Описание

skill-applicants

Кандидаты на вакансию — таблица с этапами и сводкой

skill-vacancy-stats

Статистика по вакансии — воронка, сроки, конверсия

Разработка

npm install
npm test           # vitest
npm run typecheck  # tsc --noEmit
npm run lint       # eslint
npm run format     # prettier --write
npm run dev        # tsx src/index.ts
npm run build      # tsc

Лицензия

MIT


Часть WWmcp · Telegram: @vhodvai

Available Tools

14 tools
get_applicantC

Полная информация о кандидате.

Inputs: account_id (required), applicant_id (required).

get_applicant_resumesC

Резюме кандидата (все прикреплённые external).

Inputs: account_id (required), applicant_id (required), raw. Returns: page, count, items, total, +2 more

get_resumeB

Полное тело конкретного резюме (external) кандидата.

Inputs: account_id (required), external_id (required), applicant_id (required).

get_vacancyC

Полная информация о вакансии.

Inputs: account_id (required), vacancy_id (required).

list_accountsC

Список доступных аккаунтов HuntFlow.

Inputs: raw. Returns: page, count, items, total, +2 more

list_coworkersC

Сотрудники/рекрутеры аккаунта.

Inputs: account_id (required), raw, page, count. Returns: page, count, items, total, +2 more

list_divisionsB

Справочник подразделений (отделов).

Inputs: account_id (required), raw. Returns: page, count, items, total, +2 more

list_rejection_reasonsD

Справочник причин отказа.

Inputs: account_id (required), raw. Returns: page, count, items, total, +2 more

list_sourcesC

Справочник источников кандидатов.

Inputs: account_id (required), raw. Returns: page, count, items, total, +2 more

list_stagesD

Этапы воронки подбора (статусы вакансий).

Inputs: account_id (required), raw. Returns: page, count, items, total, +2 more

list_tagsD

Справочник тегов аккаунта.

Inputs: account_id (required), raw. Returns: page, count, items, total, +2 more

list_vacanciesC

Список вакансий в HuntFlow (по умолчанию открытые).

Inputs: account_id (required), raw, mine, page, +3 more. Returns: page, count, items, total, +2 more

list_vacancy_applicantsC

Кандидаты, прикреплённые к конкретной вакансии.

Inputs: account_id (required), vacancy_id (required), raw, page, +2 more. Returns: page, count, items, total, +2 more

search_applicantsB

Поиск кандидатов по имени/email/телефону и фильтрам (вакансия, этап, тег).

Inputs: account_id (required), q, raw, tag, +4 more. Returns: page, count, items, total, +2 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 14 tools

    Disambiguation5/5

    Each tool has a clear, unique purpose covering vacancies, applicants, resumes, and reference data with no overlapping functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., get_vacancy, list_tags, search_applicants), making them predictable and readable.

    Tool Count5/5

    14 tools is within the recommended 3-15 range and appropriate for the breadth of recruitment data exposed; no redundant or unnecessary tools.

    Completeness2/5

    The toolkit is entirely read/search/list-oriented; it lacks write operations such as creating or updating applicants/vacancies, changing statuses, or adding notes, which are core to a recruitment workflow.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to search job vacancies, manage resumes, and apply to jobs on HeadHunter (hh.ru), Russia's largest job search platform. Includes OAuth 2.0 integration for secure job applications and an automated vacancy hunter agent with intelligent matching.
      38
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables AI assistants to access and manage HeadHunter job platform data, including vacancies, resumes, negotiations, and employer settings via 167+ tools.
      5
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables searching and retrieving job vacancies, resumes, employers, and salary statistics from the hh.ru API (Russia/CIS) via 19 tools, with optional token access for resume search.
      19
      96 npm
      9
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables LLM agents to query and analyze hh.ru job vacancies via full-text and semantic search, with tools for vacancy lookup, skill statistics, market overview, and candidate profile comparison.
      7
      MIT