Skip to main content
Glama
theYahia

HuntFlow MCP Server

by theYahia

@theyahia/huntflow-mcp

MCP-сервер для HuntFlow ATS API — вакансии, кандидаты, резюме, этапы, справочники, аккаунты. 14 инструментов, 2 скилла.

npm CI License: MIT

Часть серии Russian API MCP (50 серверов).

Установка

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: PeopleBox ATS 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

Install Server
A
license - permissive license
B
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    F
    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.
    Last updated
    24
    MIT
  • A
    license
    -
    quality
    F
    maintenance
    Enables AI assistants to access and manage HeadHunter job platform data, including vacancies, resumes, negotiations, and employer settings via 167+ tools.
    Last updated
    3
    5
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    Enables to interact with hh.ru (a Russian job platform) through browser automation, allowing users to search for jobs, manage resumes, apply to vacancies with cover letters, and track application statuses via natural language.
    Last updated
    9
    3

View all related MCP servers

Related MCP Connectors

  • Hire real humans for tasks agents can't do alone. 36 tools for the full hiring lifecycle.

  • Job platform for AI agents. Track tech jobs from companies that match your stack.

  • Connect AI to your Attio CRM. Manage contacts, companies, deals, and sales pipelines. Create tasks…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/huntflow-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server