Skip to main content
Glama
theYahia

HuntFlow MCP Server

@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: Viterbit 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

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