io.github.theYahia/huntflow-mcp (MCP Server)

MCP server for the HuntFlow ATS API. It supports working with vacancies, candidates, and applicants, including recruitment stages. The server is positioned as an interface to query information via Model Context Protocol (MCP) and retrieve structured results for ATS-related data.

🛠️ Key Features

HuntFlow ATS API integration for vacancies
Access to candidates and applicants
Recruitment stages and related workflow queries
Additional reference data and accounts
Categorized by 14 tools and 2 skills (as described in the excerpt)

🚀 Use Cases

Find or list candidates connected to HuntFlow recruiting
Query applicants by recruitment stage (e.g., blocked at “technical interview”)
Access ATS reference data and account information

⚡ Developer Benefits

Designed for developer consumption via MCP
Provides results as lists for stage-based queries (not CSV exports)
Includes TypeScript-focused ecosystem signals (topics include TypeScript, API, mcp-server)

⚠️ Limitations

No details provided on auth, rate limits, or tool-specific schemas beyond the documented tool/skill categories

Metadata

Topics: ai, claude, huntflow, llm, mcp, mcp-server, model-context-protocol, russian-api, typescript, api, hr, recruiting

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

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

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

Установка

Claude Desktop (stdio)

json

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

Streamable HTTP

bash

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

Smithery

bash

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

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

Настройки 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`	Статистика по вакансии — воронка, сроки, конверсия

Разработка

bash

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

io.github.theYahia/huntflow-mcp

io.github.theYahia/huntflow-mcp (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Metadata

Topics

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

Установка

Claude Desktop (stdio)

Streamable HTTP

Smithery

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

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

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

Скиллы (Prompts)

Разработка

Лицензия

Install

Configuration

Related servers