HuntFlow MCP Server
This server provides integration with the HuntFlow ATS (Applicant Tracking System) API, enabling recruitment and hiring workflow management through 14 tools and 2 skill prompts.
Account & Vacancy Management
list_accounts— Retrieve all accessible HuntFlow accountslist_vacancies— Browse vacancies with filters (open status, state, assigned to current user) and paginationget_vacancy— Fetch full details about a specific vacancy
Candidate & Resume Management
search_applicants— Search candidates by name or email, with filters for vacancy, status, and tagslist_vacancy_applicants— List candidates attached to a specific vacancyget_applicant— Retrieve complete information about a specific candidateget_applicant_resumes— Get all resumes attached to a candidateget_resume— Fetch the full body of a specific external resume
Reference Directories & Pipeline
list_stages— View recruitment pipeline stages (vacancy statuses)list_coworkers— View recruiters and employees in an accountlist_sources— Browse the candidate source reference directorylist_rejection_reasons— View rejection reason reference datalist_divisions— Browse organizational divisionslist_tags— View available candidate tags
Skill Prompts
skill-applicants— Generate a table of candidates for a vacancy with stages and summaryskill-vacancy-stats— Produce vacancy statistics including funnel, timelines, and conversion rates
Key Features: Returns curated fields by default to save tokens (use raw: true for full API responses); supports pagination via page/count parameters; includes automatic token refresh and rate limiting (10 req/s).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@HuntFlow MCP Server list my open vacancies"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP-сервер для Huntflow — вакансии, кандидаты и резюме ATS через ИИ
Если вы искали, как подключить Huntflow к нейросети, найти кандидата и прочитать его резюме не листая карточки в ATS — это оно. 14 инструментов и 2 скилла: вакансии, кандидаты, резюме, этапы подбора, справочники, аккаунты. Спрашиваете «кто застрял на этапе техинтервью» — получаете список, а не выгрузку в CSV.
Часть серии 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-mcpRelated 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 дней), затем потребуется новый токен.
Переменные окружения
Переменная | Обяз. | Описание |
| да | Access-токен (Настройки → API-токены) |
| нет | Refresh-токен — включает авто-обновление при 401 |
| нет | Файл для хранения ротированной пары (по умолчанию |
| нет | По умолчанию |
| нет | User-Agent (обязателен для API; есть дефолт) |
| нет | Таймаут запроса, мс (по умолчанию 10000) |
| нет |
|
| нет | Порт HTTP-сервера (по умолчанию 3000) |
| нет | Хост привязки HTTP (по умолчанию |
| нет | Если задан — требует |
| нет | Список host:port для защиты от DNS-rebinding |
Инструменты (14)
Инструмент | Описание |
| Список доступных аккаунтов |
| Список вакансий (фильтры |
| Полная информация о вакансии |
| Поиск кандидатов ( |
| Кандидаты, прикреплённые к конкретной вакансии |
| Полная информация о кандидате |
| Список резюме (external) кандидата |
| Полное тело конкретного резюме (external) |
| Этапы воронки подбора (статусы вакансий) |
| Сотрудники/рекрутеры аккаунта |
| Справочник источников кандидатов |
| Справочник причин отказа |
| Справочник подразделений |
| Справочник тегов |
Списочные инструменты возвращают курированный набор полей (экономия токенов) + structuredContent; передайте raw: true для полного сырого ответа. Пагинация — параметры page/count.
Скиллы (Prompts)
Скилл | Описание |
| Кандидаты на вакансию — таблица с этапами и сводкой |
| Статистика по вакансии — воронка, сроки, конверсия |
Разработка
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
Available Tools
14 toolsget_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
Scored across 14 tools
Each tool has a clear, unique purpose covering vacancies, applicants, resumes, and reference data with no overlapping functionality.
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.
14 tools is within the recommended 3-15 range and appropriate for the breadth of recruitment data exposed; no redundant or unnecessary tools.
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
Related MCP Connectors
Recruitment ATS + CRM for agencies: candidates, jobs, pipeline and outreach, with your permissions.
Resume parsing, scoring and ranking, talent pool search and skills for recruiting AI agents.
Recruiting workspace: your ATS and CRM, candidate emails, LinkedIn, calls, meetings and matching.
Tailor resumes, score ATS fit, find hiring leads, and send cold outreach, from your agent.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.38MIT
- AlicenseNot gradedqualityFmaintenanceEnables AI assistants to access and manage HeadHunter job platform data, including vacancies, resumes, negotiations, and employer settings via 167+ tools.5MIT
- AlicenseAqualityBmaintenanceEnables 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.1996 npm9MIT
- AlicenseAqualityBmaintenanceEnables 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.7MIT